Reports: request

রিপোর্টিং সিস্টেমে একটি রিপোর্ট অনুরোধ সন্নিবেশ করান। এখনই চেষ্টা করে দেখুন

অনুরোধ

HTTP অনুরোধ

POST https://www.googleapis.com/doubleclicksearch/v2/reports

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত সুযোগের সাথে অনুমোদন প্রয়োজন:

ব্যাপ্তি
https://www.googleapis.com/auth/doubleclicksearch

আরও তথ্যের জন্য, প্রমাণীকরণ এবং অনুমোদন পৃষ্ঠাটি দেখুন।

শরীরের অনুরোধ

অনুরোধের অংশে, নিম্নলিখিত কাঠামোর সাথে ডেটা সরবরাহ করুন:

{
  "reportScope": {
    "agencyId": long,
    "advertiserId": long,
    "engineAccountId": long,
    "campaignId": long,
    "adGroupId": long,
    "keywordId": long,
    "adId": long
  },
  "reportType": string,
  "columns": [
    {
      "columnName": string,
      "savedColumnName": string,
      "customDimensionName": string,
      "customMetricName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string,
      "groupByColumn": boolean,
      "platformSource": string,
      "productReportPerspective": string
    }
  ],
  "timeRange": {
    "startDate": string,
    "endDate": string,
    "changedMetricsSinceTimestamp": datetime,
    "changedAttributesSinceTimestamp": datetime
  },
  "filters": [
    {
      "column": {
        "columnName": string,
        "savedColumnName": string,
        "customDimensionName": string,
        "customMetricName": string,
        "headerText": string,
        "startDate": string,
        "endDate": string,
        "groupByColumn": boolean,
        "platformSource": string,
        "productReportPerspective": string
      },
      "operator": string,
      "values": [
        (value)
      ]
    }
  ],
  "orderBy": [
    {
      "column": {
        "columnName": string,
        "savedColumnName": string,
        "customDimensionName": string,
        "customMetricName": string,
        "headerText": string,
        "startDate": string,
        "endDate": string,
        "groupByColumn": boolean,
        "platformSource": string,
        "productReportPerspective": string
      },
      "sortOrder": string
    }
  ],
  "includeDeletedEntities": boolean,
  "includeRemovedEntities": boolean,
  "verifySingleTimeZone": boolean,
  "downloadFormat": string,
  "statisticsCurrency": string,
  "startRow": integer,
  "rowCount": integer,
  "maxRowsPerFile": integer
}
সম্পত্তির নাম মান বর্ণনা নোট
reportScope object রিপোর্টস্কোপ হল আইডিগুলির একটি সেট যা রিপোর্টে কোন সত্তার উপসেট ফেরত দেওয়া হবে তা নির্ধারণ করতে ব্যবহৃত হয়। এজেন্সির মাধ্যমে কাঙ্ক্ষিত সর্বনিম্ন স্কোপড স্তর থেকে আইডিগুলির সম্পূর্ণ বংশের প্রয়োজন৷
reportScope. agencyId long ডিএস এজেন্সি আইডি।
reportScope. advertiserId long DS বিজ্ঞাপনদাতা আইডি।
reportScope. engineAccountId long ডিএস ইঞ্জিন অ্যাকাউন্ট আইডি।
reportScope. campaignId long DS প্রচারের আইডি।
reportScope. adGroupId long DS বিজ্ঞাপন গ্রুপ আইডি।
reportScope. keywordId long ডিএস কীওয়ার্ড আইডি।
reportScope. adId long ডিএস বিজ্ঞাপন আইডি।
reportType string রিপোর্টে প্রত্যাবর্তন করা সারির ধরন নির্ধারণ করে। উদাহরণ স্বরূপ, যদি আপনি reportType: keyword নির্দিষ্ট করেন, রিপোর্টের প্রতিটি সারিতে একটি কীওয়ার্ড সম্পর্কে ডেটা থাকবে। প্রতিটি প্রকারের জন্য উপলব্ধ কলামগুলির জন্য প্রতিবেদনের রেফারেন্সের প্রকারগুলি দেখুন৷
columns[] list প্রতিবেদনে অন্তর্ভুক্ত করার জন্য কলাম। এতে DoubleClick অনুসন্ধান কলাম এবং সংরক্ষিত কলাম উভয়ই অন্তর্ভুক্ত রয়েছে। DoubleClick অনুসন্ধান কলামগুলির জন্য, শুধুমাত্র columnName প্যারামিটার প্রয়োজন৷ সংরক্ষিত কলামের জন্য শুধুমাত্র savedColumnName প্যারামিটার প্রয়োজন। columnName এবং savedColumnName উভয়ই একই স্তবকে সেট করা যাবে না।

প্রতি অনুরোধে সর্বোচ্চ 300টি কলাম।

columns[]. columnName string রিপোর্টে অন্তর্ভুক্ত করার জন্য একটি DoubleClick অনুসন্ধান কলামের নাম।
columns[]. savedColumnName string প্রতিবেদনে অন্তর্ভুক্ত করার জন্য একটি সংরক্ষিত কলামের নাম৷ প্রতিবেদনটি অবশ্যই বিজ্ঞাপনদাতা বা তার নিচের দিকে স্কোপ করা উচিত এবং এই সংরক্ষিত কলামটি অবশ্যই DoubleClick অনুসন্ধান UI-তে তৈরি করা আবশ্যক৷
columns[]. headerText string রিপোর্ট আউটপুটে এই কলাম সনাক্ত করতে ব্যবহৃত পাঠ্য; নির্দিষ্ট না থাকলে columnName বা savedColumnName এ ডিফল্ট। এটি DoubleClick অনুসন্ধান কলাম এবং একই নামের সংরক্ষিত কলামগুলির মধ্যে সংঘর্ষ প্রতিরোধ করতে ব্যবহার করা যেতে পারে।
columns[]. startDate string YYYY-MM-DD ফর্ম্যাটে অন্তর্ভুক্ত তারিখ। প্রদান করা হলে, এটি শুধুমাত্র এই কলামের জন্য প্রতিবেদনের সামগ্রিক সময়সীমাকে ওভাররাইড করে। endDate সাথে অবশ্যই প্রদান করতে হবে।
columns[]. endDate string YYYY-MM-DD ফর্ম্যাটে অন্তর্ভুক্ত দিন। প্রদান করা হলে, এটি শুধুমাত্র এই কলামের জন্য প্রতিবেদনের সামগ্রিক সময়সীমাকে ওভাররাইড করে। startDate এর সাথে অবশ্যই প্রদান করতে হবে।
columns[]. groupByColumn boolean শুধুমাত্র সিঙ্ক্রোনাস রিপোর্ট। এই কলাম দ্বারা গোষ্ঠীতে true সেট করুন৷ ডিফল্ট থেকে false
timeRange object যদি একটি প্রতিবেদনে মেট্রিক্সের অনুরোধ করা হয়, তাহলে এই যুক্তিটি একটি নির্দিষ্ট সময়সীমার মধ্যে মেট্রিক্সকে সীমাবদ্ধ করতে ব্যবহার করা হবে।
timeRange. startDate string YYYY-MM-DD ফর্ম্যাটে অন্তর্ভুক্ত তারিখ।
timeRange. endDate string YYYY-MM-DD ফর্ম্যাটে অন্তর্ভুক্ত তারিখ।
timeRange. changedMetricsSinceTimestamp datetime RFC ফর্ম্যাটে অন্তর্ভুক্ত UTC টাইমস্ট্যাম্প, যেমন, 2013-07-16T10:16:23.555Z । পরিবর্তিত মেট্রিক্স রিপোর্ট কিভাবে কাজ করে তার অতিরিক্ত রেফারেন্স দেখুন।
timeRange. changedAttributesSinceTimestamp datetime RFC ফর্ম্যাটে অন্তর্ভুক্ত UTC টাইমস্ট্যাম্প, যেমন, 2013-07-16T10:16:23.555Z । পরিবর্তিত অ্যাট্রিবিউট রিপোর্ট কিভাবে কাজ করে তার অতিরিক্ত রেফারেন্স দেখুন।
filters[] list প্রতিবেদনে প্রয়োগ করা ফিল্টারের একটি তালিকা।

প্রতি অনুরোধে ফিল্টারের সর্বোচ্চ সংখ্যা 300।

filters[]. column nested object ফিল্টার সঞ্চালনের জন্য কলাম। এটি একটি DoubleClick অনুসন্ধান কলাম বা একটি সংরক্ষিত কলাম হতে পারে৷
filters[].column. columnName string রিপোর্টে অন্তর্ভুক্ত করার জন্য একটি DoubleClick অনুসন্ধান কলামের নাম।
filters[].column. savedColumnName string প্রতিবেদনে অন্তর্ভুক্ত করার জন্য একটি সংরক্ষিত কলামের নাম৷ প্রতিবেদনটি অবশ্যই বিজ্ঞাপনদাতা বা তার নিচের দিকে স্কোপ করা উচিত এবং এই সংরক্ষিত কলামটি অবশ্যই DoubleClick অনুসন্ধান UI-তে তৈরি করা আবশ্যক৷
filters[]. operator string ফিল্টার ব্যবহার করতে অপারেটর. উপলব্ধ অপারেটরগুলির একটি তালিকার জন্য ফিল্টার রেফারেন্স দেখুন।
filters[]. values[] list কলামের মানের বিপরীতে ফিল্টার করার জন্য মানগুলির একটি তালিকা৷

প্রতি অনুরোধ ফিল্টার মান সর্বোচ্চ 300 হয়.

orderBy[] list শুধুমাত্র সিঙ্ক্রোনাস রিপোর্ট। প্রতিবেদনের সারিতে সঞ্চালিত বাছাই সংজ্ঞায়িত কলাম এবং দিকনির্দেশের একটি তালিকা।

প্রতি অনুরোধের সর্বোচ্চ সংখ্যা 300টি।

orderBy[]. column nested object বাছাই করার জন্য কলাম। এটি একটি DoubleClick অনুসন্ধান-সংজ্ঞায়িত কলাম বা একটি সংরক্ষিত কলাম হতে পারে৷
orderBy[].column. columnName string রিপোর্টে অন্তর্ভুক্ত করার জন্য একটি DoubleClick অনুসন্ধান কলামের নাম।
orderBy[].column. savedColumnName string প্রতিবেদনে অন্তর্ভুক্ত করার জন্য একটি সংরক্ষিত কলামের নাম৷ প্রতিবেদনটি অবশ্যই বিজ্ঞাপনদাতা বা তার নিচের দিকে স্কোপ করা উচিত এবং এই সংরক্ষিত কলামটি অবশ্যই DoubleClick অনুসন্ধান UI-তে তৈরি করা আবশ্যক৷
orderBy[]. sortOrder string সাজানোর দিক, যা হয় ascending বা descending
includeDeletedEntities boolean প্রতিবেদনে অপসারিত সত্তাগুলিকে অন্তর্ভুক্ত করা উচিত কিনা তা নির্ধারণ করে। ডিফল্ট থেকে false । অপ্রচলিত, অনুগ্রহ করে এর পরিবর্তে includeRemovedEntities ব্যবহার করুন।
verifySingleTimeZone boolean true হলে, প্রতিবেদনটি শুধুমাত্র তখনই তৈরি করা হবে যখন অনুরোধ করা সমস্ত স্ট্যাট ডেটা একটি একক টাইমজোন থেকে নেওয়া হয়। ডিফল্ট থেকে false
downloadFormat string যে ফর্ম্যাটে রিপোর্টটি ফেরত দেওয়া উচিত। বর্তমানে csv বা tsv সমর্থিত।
statisticsCurrency string যে মুদ্রায় মুদ্রা ফেরত দেওয়া হবে তা নির্দিষ্ট করে। সম্ভাব্য মানগুলি হল: usd , agency (প্রতিবেদনটি এজেন্সি বা তার চেয়ে কম হলে বৈধ), advertiser (প্রতিবেদনটি * বিজ্ঞাপনদাতা বা নিম্নতর হলে বৈধ), বা account (বৈধ যদি প্রতিবেদনটি ইঞ্জিন অ্যাকাউন্টে বা তার চেয়ে কম হয়) .
startRow integer শুধুমাত্র সিঙ্ক্রোনাস রিপোর্ট। প্রথম সারির শূন্য-ভিত্তিক সূচক ফেরত দিতে হবে। গ্রহণযোগ্য মান হল 0 থেকে 50000 , সমেত। ডিফল্ট 0 .
rowCount integer শুধুমাত্র সিঙ্ক্রোনাস রিপোর্ট। সর্বাধিক সংখ্যক সারিতে ফিরতে হবে; অতিরিক্ত সারি বাদ দেওয়া হয়। গ্রহণযোগ্য মান হল 0 থেকে 10000 , সমেত। ডিফল্ট 10000
maxRowsPerFile integer শুধুমাত্র অ্যাসিঙ্ক্রোনাস রিপোর্ট। রিপোর্ট ফাইল প্রতি সারি সর্বোচ্চ সংখ্যা. এই ক্ষেত্রের উপর ভিত্তি করে একটি বড় রিপোর্ট অনেক ফাইলে বিভক্ত। গ্রহণযোগ্য মান হল 1000000 থেকে 100000000 , অন্তর্ভুক্ত।
includeRemovedEntities boolean প্রতিবেদনে অপসারিত সত্তাগুলিকে অন্তর্ভুক্ত করা উচিত কিনা তা নির্ধারণ করে। ডিফল্ট থেকে false
columns[]. customDimensionName string একটি কাস্টম মাত্রা দ্বারা একটি প্রতিবেদনকে ভাগ করে। প্রতিবেদনটি অবশ্যই বিজ্ঞাপনদাতার কাছে বা তার চেয়ে কম হতে হবে এবং কাস্টম মাত্রা অবশ্যই DoubleClick অনুসন্ধানে সেট আপ করা আবশ্যক৷ কাস্টম ডাইমেনশন নাম, যা DoubleClick অনুসন্ধানে প্রদর্শিত হয়, কেস সংবেদনশীল।

একটি রূপান্তর প্রতিবেদনে ব্যবহার করা হলে, প্রদত্ত রূপান্তরের জন্য নির্দিষ্ট কাস্টম মাত্রার মান প্রদান করে, যদি সেট করা হয়। এই কলামটি রূপান্তর প্রতিবেদনকে ভাগ করে না।

columns[]. platformSource string প্ল্যাটফর্ম যা কাস্টম মাত্রার জন্য ডেটা প্রদান করতে ব্যবহৃত হয়। গ্রহণযোগ্য মান হল "ফ্লাডলাইট"।
filters[].column. customDimensionName string একটি কাস্টম মাত্রা দ্বারা একটি প্রতিবেদনকে ভাগ করে। প্রতিবেদনটি অবশ্যই বিজ্ঞাপনদাতার কাছে বা তার চেয়ে কম হতে হবে এবং কাস্টম মাত্রা অবশ্যই DoubleClick অনুসন্ধানে সেট আপ করা আবশ্যক৷ কাস্টম ডাইমেনশন নাম, যা DoubleClick অনুসন্ধানে প্রদর্শিত হয়, কেস সংবেদনশীল।

একটি রূপান্তর প্রতিবেদনে ব্যবহার করা হলে, প্রদত্ত রূপান্তরের জন্য নির্দিষ্ট কাস্টম মাত্রার মান প্রদান করে, যদি সেট করা হয়। এই কলামটি রূপান্তর প্রতিবেদনকে ভাগ করে না।

filters[].column. headerText string রিপোর্ট আউটপুটে এই কলাম সনাক্ত করতে ব্যবহৃত পাঠ্য; নির্দিষ্ট না থাকলে columnName বা savedColumnName এ ডিফল্ট। এটি DoubleClick অনুসন্ধান কলাম এবং একই নামের সংরক্ষিত কলামগুলির মধ্যে সংঘর্ষ প্রতিরোধ করতে ব্যবহার করা যেতে পারে।
filters[].column. startDate string YYYY-MM-DD ফর্ম্যাটে অন্তর্ভুক্ত তারিখ। প্রদান করা হলে, এটি শুধুমাত্র এই কলামের জন্য প্রতিবেদনের সামগ্রিক সময়সীমাকে ওভাররাইড করে। endDate সাথে অবশ্যই প্রদান করতে হবে।
filters[].column. endDate string YYYY-MM-DD ফর্ম্যাটে অন্তর্ভুক্ত দিন। প্রদান করা হলে, এটি শুধুমাত্র এই কলামের জন্য প্রতিবেদনের সামগ্রিক সময়সীমাকে ওভাররাইড করে। startDate এর সাথে অবশ্যই প্রদান করতে হবে।
filters[].column. groupByColumn boolean শুধুমাত্র সিঙ্ক্রোনাস রিপোর্ট। এই কলাম দ্বারা গোষ্ঠীতে true সেট করুন৷ ডিফল্ট থেকে false
filters[].column. platformSource string প্ল্যাটফর্ম যা কাস্টম মাত্রার জন্য ডেটা প্রদান করতে ব্যবহৃত হয়। গ্রহণযোগ্য মান হল "ফ্লাডলাইট"।
orderBy[].column. customDimensionName string একটি কাস্টম মাত্রা দ্বারা একটি প্রতিবেদনকে ভাগ করে। প্রতিবেদনটি অবশ্যই বিজ্ঞাপনদাতার কাছে বা তার চেয়ে কম হতে হবে এবং কাস্টম মাত্রা অবশ্যই DoubleClick অনুসন্ধানে সেট আপ করা আবশ্যক৷ কাস্টম ডাইমেনশন নাম, যা DoubleClick অনুসন্ধানে প্রদর্শিত হয়, কেস সংবেদনশীল।

একটি রূপান্তর প্রতিবেদনে ব্যবহার করা হলে, প্রদত্ত রূপান্তরের জন্য নির্দিষ্ট কাস্টম মাত্রার মান প্রদান করে, যদি সেট করা হয়। এই কলামটি রূপান্তর প্রতিবেদনকে ভাগ করে না।

orderBy[].column. headerText string রিপোর্ট আউটপুটে এই কলাম সনাক্ত করতে ব্যবহৃত পাঠ্য; নির্দিষ্ট না থাকলে columnName বা savedColumnName এ ডিফল্ট। এটি DoubleClick অনুসন্ধান কলাম এবং একই নামের সংরক্ষিত কলামগুলির মধ্যে সংঘর্ষ প্রতিরোধ করতে ব্যবহার করা যেতে পারে।
orderBy[].column. startDate string YYYY-MM-DD ফর্ম্যাটে অন্তর্ভুক্ত তারিখ। প্রদান করা হলে, এটি শুধুমাত্র এই কলামের জন্য প্রতিবেদনের সামগ্রিক সময়সীমাকে ওভাররাইড করে। endDate সাথে অবশ্যই প্রদান করতে হবে।
orderBy[].column. endDate string YYYY-MM-DD ফর্ম্যাটে অন্তর্ভুক্ত দিন। প্রদান করা হলে, এটি শুধুমাত্র এই কলামের জন্য প্রতিবেদনের সামগ্রিক সময়সীমাকে ওভাররাইড করে। startDate এর সাথে অবশ্যই প্রদান করতে হবে।
orderBy[].column. groupByColumn boolean শুধুমাত্র সিঙ্ক্রোনাস রিপোর্ট। এই কলাম দ্বারা গোষ্ঠীতে true সেট করুন৷ ডিফল্ট থেকে false
orderBy[].column. platformSource string প্ল্যাটফর্ম যা কাস্টম মাত্রার জন্য ডেটা প্রদান করতে ব্যবহৃত হয়। গ্রহণযোগ্য মান হল "ফ্লাডলাইট"।
columns[]. customMetricName string প্রতিবেদনে অন্তর্ভুক্ত করার জন্য একটি কাস্টম মেট্রিকের নাম। প্রতিবেদনটি অবশ্যই বিজ্ঞাপনদাতা বা তার চেয়ে কম হতে হবে এবং কাস্টম মেট্রিকটি অবশ্যই DoubleClick অনুসন্ধানে সেট আপ করা আবশ্যক৷ কাস্টম মেট্রিক নাম, যা DoubleClick অনুসন্ধানে প্রদর্শিত হয়, কেস সংবেদনশীল।
filters[].column. customMetricName string প্রতিবেদনে অন্তর্ভুক্ত করার জন্য একটি কাস্টম মেট্রিকের নাম। প্রতিবেদনটি অবশ্যই বিজ্ঞাপনদাতা বা তার চেয়ে কম হতে হবে এবং কাস্টম মেট্রিকটি অবশ্যই DoubleClick অনুসন্ধানে সেট আপ করা আবশ্যক৷ কাস্টম মেট্রিক নাম, যা DoubleClick অনুসন্ধানে প্রদর্শিত হয়, কেস সংবেদনশীল।
orderBy[].column. customMetricName string প্রতিবেদনে অন্তর্ভুক্ত করার জন্য একটি কাস্টম মেট্রিকের নাম। প্রতিবেদনটি অবশ্যই বিজ্ঞাপনদাতা বা তার চেয়ে কম হতে হবে এবং কাস্টম মেট্রিকটি অবশ্যই DoubleClick অনুসন্ধানে সেট আপ করা আবশ্যক৷ কাস্টম মেট্রিক নাম, যা DoubleClick অনুসন্ধানে প্রদর্শিত হয়, কেস সংবেদনশীল।
columns[]. productReportPerspective string শুধুমাত্র একটি নির্দিষ্ট ধরনের পণ্য কার্যকলাপের জন্য মেট্রিক্স প্রদান করে। গৃহীত মান হল:
  • " sold ": শুধুমাত্র বিক্রি করা পণ্যের জন্য মেট্রিক্স প্রদান করে
  • " advertised ": শুধুমাত্র সেই পণ্যগুলির জন্য মেট্রিক্স প্রদান করে যেগুলি একটি শপিং প্রচারে বিজ্ঞাপন দেওয়া হয়েছিল, এবং যেগুলি বিক্রি হতে পারে বা নাও হতে পারে
filters[].column. productReportPerspective string শুধুমাত্র একটি নির্দিষ্ট ধরনের পণ্য কার্যকলাপের জন্য মেট্রিক্স প্রদান করে। গৃহীত মান হল:
  • " sold ": শুধুমাত্র বিক্রি করা পণ্যের জন্য মেট্রিক্স প্রদান করে
  • " advertised ": শুধুমাত্র সেই পণ্যগুলির জন্য মেট্রিক্স প্রদান করে যেগুলি একটি শপিং প্রচারে বিজ্ঞাপন দেওয়া হয়েছিল, এবং যেগুলি বিক্রি হতে পারে বা নাও হতে পারে
orderBy[].column. productReportPerspective string শুধুমাত্র একটি নির্দিষ্ট ধরনের পণ্য কার্যকলাপের জন্য মেট্রিক্স প্রদান করে। গৃহীত মান হল:
  • " sold ": শুধুমাত্র বিক্রি করা পণ্যের জন্য মেট্রিক্স প্রদান করে
  • " advertised ": শুধুমাত্র সেই পণ্যগুলির জন্য মেট্রিক্স প্রদান করে যেগুলি একটি শপিং প্রচারে বিজ্ঞাপন দেওয়া হয়েছিল, এবং যেগুলি বিক্রি হতে পারে বা নাও হতে পারে

প্রতিক্রিয়া

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি প্রতিবেদন সংস্থান প্রদান করে।

এটা চেষ্টা করুন!

লাইভ ডেটাতে এই পদ্ধতিতে কল করতে এবং প্রতিক্রিয়া দেখতে নীচের APIs এক্সপ্লোরার ব্যবহার করুন। বিকল্পভাবে, স্বতন্ত্র এক্সপ্লোরার ব্যবহার করে দেখুন।