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 এক্সপ্লোরার ব্যবহার করুন। বিকল্পভাবে, স্বতন্ত্র এক্সপ্লোরার ব্যবহার করে দেখুন।