এই পৃষ্ঠাটি Google বিড ম্যানেজার API-এর জন্য রিলিজ নোট প্রদান করে।
সংস্করণ 2
পরিষেবার শেষ পয়েন্ট আপডেট করা এবং পরিষেবা ও পদ্ধতির নামকরণ সহ API-এ কাঠামোগত পরিবর্তন করা হয়েছে৷
অপ্রয়োজনীয় ক্ষেত্রগুলি সরিয়ে, বিদ্যমান ক্ষেত্রগুলিকে পুনর্গঠন করে এবং ক্ষেত্রের ধরন পরিবর্তন করে উল্লেখযোগ্যভাবে আপডেট করা কোয়েরি এবং রিপোর্ট সংস্থান। এটি একটি সাধারণ "নেস্টেড অবজেক্ট" সংজ্ঞার পরিবর্তে নামযুক্ত বস্তু ব্যবহার করার জন্য ক্ষেত্রের ধরন পরিবর্তন অন্তর্ভুক্ত করে।
তৈরির পরে স্বয়ংক্রিয়ভাবে চালানোর পরিবর্তে queries.run
পদ্ধতি ব্যবহার করে অ্যাড-হক কোয়েরি চালানোর প্রয়োজন।
queries.run
ক্যোয়ারী প্যারামিটার asynchronous
synchronous
দিয়ে প্রতিস্থাপিত হয়েছে।
নিম্নলিখিত পরিবর্তনগুলির মাধ্যমে সরলীকৃত প্রতিবেদন পুনরুদ্ধার:
- একটি
queries.reports.get
পদ্ধতির সংযোজন। -
queries.reports.list
এ একটিorderBy
কোয়েরি প্যারামিটার যোগ করা হয়েছে। -
queries.run
রেসপন্স বডির আপডেট একটি খালি অবজেক্ট থেকে জেনারেট করাReport
রিসোর্সের একটি ইনস্ট্যান্সে।
এপিআই দ্বারা ফিরে আসা আপডেট করা ত্রুটির বার্তাগুলিকে আরও সুনির্দিষ্ট হতে এবং আরও নির্দেশমূলক সমাধান প্রদান করে৷
v1.1 থেকে v2 তে স্থানান্তর করতে v2 মাইগ্রেশন গাইডে উপস্থাপিত নির্দেশাবলী অনুসরণ করুন।
নতুন বৈশিষ্ট
পরিষেবার শেষ পয়েন্ট পরিবর্তন করা হয়েছে:
v1 পরিষেবার শেষ পয়েন্ট v2 পরিষেবার শেষ পয়েন্ট https://www.googleapis.com/doubleclickbidmanager
https://doubleclickbidmanager.googleapis.com
পরিষেবাগুলির নাম পরিবর্তন করা হয়েছে নিম্নরূপ:
v1 পরিষেবা v2 পরিষেবা প্রশ্ন প্রশ্ন রিপোর্ট queries.reports পদ্ধতির নামকরণ করা হয়েছে নিম্নরূপ:
নিম্নলিখিত পদ্ধতি যোগ করা হয়েছে:
সেবা পদ্ধতি(গুলি) queries.reports পাওয়া নিম্নলিখিত পদ্ধতিগুলির একটি নতুন প্রতিক্রিয়া সংস্থা রয়েছে:
পদ্ধতি নতুন প্রতিক্রিয়া শরীরের বস্তু queries.run রিপোর্ট নিম্নলিখিত ক্ষেত্রগুলি সরানো হয়েছে:
সম্পদ ক্ষেত্র(গুলি) queries.list
রেসপন্স বডিধরনের
queries.reports.list
রেসপন্স বডিধরনের
প্রশ্ন ধরনের
রিপোর্টডেটাএন্ডটাইম এমএস
রিপোর্টডেটাস্টার্টটাইম
টাইমজোন কোড
RunQueryRequest রিপোর্টডেটাএন্ডটাইম এমএস
রিপোর্টডেটাস্টার্টটাইম
টাইমজোন কোড
নিম্নলিখিত ক্ষেত্রগুলির অবজেক্টের ধরণটি নিম্নলিখিতগুলিতে পরিবর্তন করা হয়েছে:
সম্পদ ক্ষেত্র(গুলি) অবজেক্ট টাইপ প্রশ্ন রিপোর্ট RunQueryRequest নিম্নলিখিত পদ্ধতি কোয়েরি পরামিতি যোগ করা হয়েছে:
পদ্ধতি ক্যোয়ারী প্যারামিটার(গুলি) queries.list আদেশ দ্বারা queries.reports.list আদেশ দ্বারা queries.run সিঙ্ক্রোনাস নিম্নলিখিত পদ্ধতি ক্যোয়ারী পরামিতি সরানো হয়েছে:
পদ্ধতি ক্যোয়ারী প্যারামিটার(গুলি) queries.create অ্যাসিঙ্ক্রোনাস queries.run অ্যাসিঙ্ক্রোনাস নিম্নলিখিত ফিল্টার মান যোগ করা হয়েছে:
ফিল্টার মান FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION নিম্নলিখিত ফিল্টার মানগুলি সরানো হয়েছে:
ফিল্টার মান FILTER_TRUEVIEW_IAR_REGION নিম্নলিখিত মেট্রিক মান যোগ করা হয়েছে:
মেট্রিক মান METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH
জ্ঞাত সমস্যা
কোনোটিই নয়।
সংস্করণ 1.1
কলাম ম্যাপিং রিপোর্ট করতে এক থেকে এক ফিল্টার
একাধিক রিপোর্ট কলামে ম্যাপ করা ফিল্টারগুলি এখন একক কলামে ম্যাপ করে।
উদাহরণস্বরূপ, v1-এ, FILTER_ADVERTISER
ফিল্টার সহ "বিজ্ঞাপনদাতা আইডি" ছাড়াও "বিজ্ঞাপনদাতা" কলাম সহ একটি প্রতিবেদন দেয়৷ v1.1-এ, সমস্ত রিপোর্ট কলামের নিজস্ব ফিল্টার আছে। উদাহরণস্বরূপ, একটি নতুন ফিল্টার FILTER_ADVERTISER_NAME
ম্যাপ করে "বিজ্ঞাপনদাতা"। প্রতিবেদনে "বিজ্ঞাপনদাতা আইডি" এবং "বিজ্ঞাপনদাতা" উভয় কলাম পেতে, উভয় ফিল্টার FILTER_ADVERTISER
এবং FILTER_ADVERTISER_NAME
, যথাক্রমে, Queries.createquery
অনুরোধগুলিতে অন্তর্ভুক্ত করতে হবে৷
আরও সুনির্দিষ্টভাবে, createquery
অনুরোধ:
{
...
"params": {
...
"groupBys": ["FILTER_ADVERTISER"],
"metrics": ["METRIC_IMPRESSIONS"],
...
}
...
}
v1 এ নিম্নলিখিত শিরোনাম সহ একটি প্রতিবেদন ফাইল তৈরি করে:
Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions
এবং v1.1-এ নিম্নলিখিত হেডার:
Advertiser,Impressions
উপরের উদাহরণে রিপোর্ট কলাম পেতে নিম্নলিখিত v1 কোড ব্যবহার করা হয়েছে:
List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
new com.google.api.services.doubleclickbidmanager.model.Parameters()
.setGroupBys(groupBys)
.setMetrics(metrics);
v1.1-এ নিম্নলিখিতগুলির অনুরূপ পরিবর্তন করতে হবে (দ্রষ্টব্য ফিল্টার অর্ডারিং):
List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER_NAME");
groupBys.add("FILTER_ADVERTISER");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_STATUS");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_CODE");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
new com.google.api.services.doubleclickbidmanager.model.Parameters()
.setGroupBys(groupBys)
.setMetrics(metrics);
আসল ফিল্টার | ফিল্টার যোগ করা হয়েছে |
---|---|
FILTER_ADVERTISER | FILTER_ADVERTISER_NAME FILTER_ADVERTISER_INTEGRATION_CODE FILTER_ADVERTISER_INTEGRATION_STATUS |
FILTER_AD_POSITION | FILTER_AD_POSITION_NAME |
FILTER_CARRIER | FILTER_CARRIER_NAME |
FILTER_CHANNEL_ID | FILTER_CHANNEL_NAME |
FILTER_CITY | FILTER_CITY_NAME |
FILTER_COMPANION_CREATIVE_ID | FILTER_COMPANION_CREATIVE_NAME |
FILTER_DMA | FILTER_DMA_NAME |
FILTER_INSERTION_ORDER | FILTER_INSERTION_ORDER_NAME |
FILTER_PARTNER | FILTER_PARTNER_NAME FILTER_PARTNER_STATUS |
FILTER_REGION | FILTER_REGION_NAME |
FILTER_TRUEVIEW_DMA | FILTER_TRUEVIEW_DMA_NAME |
FILTER_TRUEVIEW_IAR_REGION | FILTER_TRUEVIEW_IAR_REGION_NAME |
FILTER_USER_LIST_FIRST_PARTY | FILTER_USER_LIST_FIRST_PARTY_NAME |
FILTER_USER_LIST_THIRD_PARTY | FILTER_USER_LIST_THIRD_PARTY_NAME |
পৃষ্ঠা সংখ্যা
v1.1 পদ্ধতি Queries.listqueries
এবং Reports.listreports
পৃষ্ঠা সংখ্যা যোগ করে।
v1.1-এ, এই পদ্ধতিগুলি দ্বারা প্রত্যাবর্তিত ফলাফলের সংখ্যা একটি নতুন যোগ করা প্যারামিটার pageSize
সমান (নির্দিষ্ট না থাকলে এটি ডিফল্ট 100
)। প্রতিক্রিয়াগুলিতে একটি নতুন যুক্ত করা nextPageToken
ক্ষেত্র রয়েছে যা পরবর্তী ফলাফলের সেট পুনরুদ্ধার করতে ব্যবহার করা যেতে পারে। ফলাফল শেষ হয়ে গেলে এই ক্ষেত্রটি ফাঁকা।
একটি নির্দিষ্ট প্রশ্নের সাথে সম্পর্কিত সমস্ত প্রতিবেদন পুনরুদ্ধার করতে নিম্নলিখিত v1 কোড:
public class GetReports {
public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();
return reportListResponse.getReports();
}
}
সমস্ত রিপোর্ট পুনরুদ্ধার করা চালিয়ে যাওয়ার জন্য, v1.1-এ নিম্নলিখিতগুলির মতোই সংশোধন করতে হবে:
public class GetReports {
public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();
List<Report> reports = new ArrayList<>(reportListResponse.getReports());
while (reportListResponse.getNextPageToken() != null
&& reportListResponse.getNextPageToken().length() > 0) {
// Get next set of results, aka page.
reportListResponse =
service
.reports()
.listreports(queryId)
.setPageToken(reportListResponse.getNextPageToken())
.execute();
reports.addAll(reportListResponse.getReports());
}
return reports;
}
}
আরো বিস্তারিত জানার জন্য Queries.listqueries
এবং Reports.listreports
পদ্ধতি ডকুমেন্টেশন দেখুন।
জ্ঞাত সমস্যা
কোনোটিই নয়।
সংস্করণ 1
এটি API এর প্রাথমিক সংস্করণ।
জ্ঞাত সমস্যা
কোনোটিই নয়।