অব্যাহতি পত্র

এই পৃষ্ঠাটি Google বিড ম্যানেজার API-এর জন্য রিলিজ নোট প্রদান করে।

সংস্করণ 2

পরিষেবার শেষ পয়েন্ট আপডেট করা এবং পরিষেবা ও পদ্ধতির নামকরণ সহ API-এ কাঠামোগত পরিবর্তন করা হয়েছে৷

অপ্রয়োজনীয় ক্ষেত্রগুলি সরিয়ে, বিদ্যমান ক্ষেত্রগুলিকে পুনর্গঠন করে এবং ক্ষেত্রের ধরন পরিবর্তন করে উল্লেখযোগ্যভাবে আপডেট করা কোয়েরি এবং রিপোর্ট সংস্থান। এটি একটি সাধারণ "নেস্টেড অবজেক্ট" সংজ্ঞার পরিবর্তে নামযুক্ত বস্তু ব্যবহার করার জন্য ক্ষেত্রের ধরন পরিবর্তন অন্তর্ভুক্ত করে।

তৈরির পরে স্বয়ংক্রিয়ভাবে চালানোর পরিবর্তে queries.run পদ্ধতি ব্যবহার করে অ্যাড-হক কোয়েরি চালানোর প্রয়োজন।

queries.run ক্যোয়ারী প্যারামিটার asynchronous synchronous দিয়ে প্রতিস্থাপিত হয়েছে।

নিম্নলিখিত পরিবর্তনগুলির মাধ্যমে সরলীকৃত প্রতিবেদন পুনরুদ্ধার:

  • একটি queries.reports.get পদ্ধতির সংযোজন।
  • queries.reports.list এ একটি orderBy কোয়েরি প্যারামিটার যোগ করা হয়েছে।
  • queries.run রেসপন্স বডির আপডেট একটি খালি অবজেক্ট থেকে জেনারেট করা Report রিসোর্সের একটি ইনস্ট্যান্সে।

এপিআই দ্বারা ফিরে আসা আপডেট করা ত্রুটির বার্তাগুলিকে আরও সুনির্দিষ্ট হতে এবং আরও নির্দেশমূলক সমাধান প্রদান করে৷

v1.1 থেকে v2 তে স্থানান্তর করতে v2 মাইগ্রেশন গাইডে উপস্থাপিত নির্দেশাবলী অনুসরণ করুন।

নতুন বৈশিষ্ট

জ্ঞাত সমস্যা

কোনোটিই নয়।

সংস্করণ 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 এর প্রাথমিক সংস্করণ।

জ্ঞাত সমস্যা

কোনোটিই নয়।