Method: customers.generateIvtReport

একটি নির্দিষ্ট প্ল্যাটফর্মের জন্য অবৈধ ট্র্যাফিক গণনার প্রতিদিনের সংক্ষিপ্তসার পুনরুদ্ধার করার জন্য একটি প্রশ্নের সম্পাদন শুরু করে৷ ফলাফলগুলি নির্দিষ্ট BigQuery গন্তব্য টেবিলে লেখা হবে। ফিরে আসা অপারেশন নামটি ক্যোয়ারী সমাপ্তির স্থিতির জন্য পোল করতে ব্যবহার করা যেতে পারে।

আউটপুট টেবিলে তারিখ পরিসরে প্রতিটি দিনের জন্য 5টি সারি রয়েছে। ৪টি ডিভাইস প্রকারের প্রতিটির জন্য ১টি সারি এবং সব ধরনের ডিভাইসের জন্য ১টি সারি। সমস্ত সারি হল সেই দিনের জন্য 4টি ধরনের ডিভাইসের সমষ্টি৷ ফলস্বরূপ, প্রতিটি কলাম ইম্প্রেশনের মোট সংখ্যার দ্বিগুণ ধারণ করে। যদি ADH গোপনীয়তার সীমাবদ্ধতার কারণে সারিগুলিকে সংশোধন করে, তাহলে ফিল্টার করা সারির সারাংশ (কোনও দিন ছাড়া সারি) সংশোধন করা সারিগুলির সমষ্টি থাকবে৷

HTTP অনুরোধ

POST https://adsdatahub.googleapis.com/v1/{name=customers/*}:generateIvtReport

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
name

string

অ্যাডস ডেটা হাব গ্রাহক অনুরোধ করছেন। এটি 'গ্রাহক/[customerId]' আকারে। যেমন 'গ্রাহক/123'।

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

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "adsDataCustomerId": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "timeZone": string,
  "destTable": string,

  // Union field platform_dimensions can be only one of the following:
  "googleAdsDimensions": {
    object (GoogleAdsDimensions)
  },
  "dv360YoutubeDimensions": {
    object (Dv360Dimensions)
  },
  "ytReserveDimensions": {
    object (YouTubeReserveDimensions)
  }
  // End of list of possible types for union field platform_dimensions.
}
ক্ষেত্র
adsDataCustomerId

string ( int64 format)

লিঙ্ক করা বিজ্ঞাপন ডেটা হাব গ্রাহক আইডি যা বিজ্ঞাপন ডেটার মালিক।

startDate

object ( Date )

প্রতিবেদন তৈরির প্রথম দিন।

endDate

object ( Date )

উত্পন্ন প্রতিবেদনের শেষ দিন, অন্তর্ভুক্ত.

timeZone

string

ঐচ্ছিক। রিপোর্টের শুরু এবং শেষ তারিখের জন্য সময় অঞ্চল। নির্দিষ্ট করা না থাকলে, 'UTC'-তে ডিফল্ট।

destTable

string

'project.dataset.table_name' ফর্ম্যাট সহ ক্যোয়ারী ফলাফলের জন্য গন্তব্য BigQuery টেবিল। নির্দিষ্ট করা থাকলে, প্রকল্পটি গ্রাহকের ADH অ্যাকাউন্টের জন্য স্পষ্টভাবে সাদা তালিকাভুক্ত হতে হবে। যদি প্রজেক্ট নির্দিষ্ট করা না থাকে, প্রদত্ত গ্রাহকের জন্য ডিফল্ট প্রকল্প ব্যবহার করে। যদি প্রকল্প বা ডেটাসেট কোনোটিই নির্দিষ্ট করা না থাকে, তাহলে ডিফল্ট প্রকল্প এবং ডেটাসেট ব্যবহার করে।

ইউনিয়ন ফিল্ড platform_dimensions । ঐচ্ছিক প্ল্যাটফর্ম-নির্দিষ্ট স্লাইসিংয়ের সাথে রিপোর্ট করার প্ল্যাটফর্ম। একটি প্ল্যাটফর্ম নির্বাচন না করার ফলে একটি ত্রুটি হবে৷ platform_dimensions নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
googleAdsDimensions

object ( GoogleAdsDimensions )

প্ল্যাটফর্ম Google বিজ্ঞাপনে রিপোর্ট করুন।

dv360YoutubeDimensions

object ( Dv360Dimensions )

প্ল্যাটফর্ম DV360 এ রিপোর্ট করুন।

ytReserveDimensions

object ( YouTubeReserveDimensions )

প্ল্যাটফর্ম YTR-এ রিপোর্ট করুন।

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

সফল হলে, প্রতিক্রিয়া বডিতে Operation একটি উদাহরণ থাকে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/adsdatahub

GoogleAds মাত্রা

Google বিজ্ঞাপন প্ল্যাটফর্মের জন্য ফিল্টারিং মাত্রা।

JSON প্রতিনিধিত্ব
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
ক্ষেত্র
campaignIds[]

string ( int64 format)

ঐচ্ছিক Google বিজ্ঞাপন প্রচার আইডি। খালি থাকলে, নির্দিষ্ট সময়ের জন্য সমস্ত প্রচারাভিযানের রিপোর্ট।

metricType

enum ( MetricType )

পরিমাপ এবং রিপোর্ট করার জন্য প্ল্যাটফর্ম মনোনীত করে।

মেট্রিক টাইপ

পরিমাপ এবং রিপোর্ট করার জন্য প্ল্যাটফর্ম মনোনীত করে।

এনামস
METRIC_TYPE_UNSPECIFIED অনির্দিষ্ট মেট্রিক প্রকার।
METRIC_TYPE_IMPRESSION Google বিজ্ঞাপন ইম্প্রেশন ডেটা।
METRIC_TYPE_YOUTUBE_VIEW YouTube ভিউ ওরফে TrueView ভিউ।

Dv360 মাত্রা

DV360 প্ল্যাটফর্মের জন্য ফিল্টারিং মাত্রা।

JSON প্রতিনিধিত্ব
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
ক্ষেত্র
lineItemIds[]

string ( int64 format)

ঐচ্ছিক DV360 লাইন আইটেম আইডি। খালি থাকলে, নির্দিষ্ট সময়ের জন্য সমস্ত লাইন আইটেমের রিপোর্ট।

metricType

enum ( MetricType )

পরিমাপ এবং রিপোর্ট করার জন্য প্ল্যাটফর্ম মনোনীত করে।

YouTube রিজার্ভ মাত্রা

YouTube রিজার্ভ প্ল্যাটফর্মের জন্য ফিল্টারিং মাত্রা।

JSON প্রতিনিধিত্ব
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
ক্ষেত্র
orderIds[]

string ( int64 format)

ঐচ্ছিক YouTube রিজার্ভ অর্ডার আইডি। খালি থাকলে, নির্দিষ্ট সময়ের জন্য সমস্ত অর্ডারের রিপোর্ট।

metricType

enum ( MetricType )

পরিমাপ এবং রিপোর্ট করার জন্য প্ল্যাটফর্ম মনোনীত করে।

,

একটি নির্দিষ্ট প্ল্যাটফর্মের জন্য অবৈধ ট্র্যাফিক গণনার প্রতিদিনের সংক্ষিপ্তসার পুনরুদ্ধার করার জন্য একটি প্রশ্নের সম্পাদন শুরু করে৷ ফলাফলগুলি নির্দিষ্ট BigQuery গন্তব্য টেবিলে লেখা হবে। ফিরে আসা অপারেশন নামটি ক্যোয়ারী সমাপ্তির স্থিতির জন্য পোল করতে ব্যবহার করা যেতে পারে।

আউটপুট টেবিলে তারিখ পরিসরে প্রতিটি দিনের জন্য 5টি সারি রয়েছে। ৪টি ডিভাইস প্রকারের প্রতিটির জন্য ১টি সারি এবং সব ধরনের ডিভাইসের জন্য ১টি সারি। সমস্ত সারি হল সেই দিনের জন্য 4টি ধরনের ডিভাইসের সমষ্টি৷ ফলস্বরূপ, প্রতিটি কলাম ইম্প্রেশনের মোট সংখ্যার দ্বিগুণ ধারণ করে। যদি ADH গোপনীয়তার সীমাবদ্ধতার কারণে সারিগুলিকে সংশোধন করে, তাহলে ফিল্টার করা সারির সারাংশ (কোনও দিন ছাড়া সারি) সংশোধন করা সারিগুলির সমষ্টি থাকবে৷

HTTP অনুরোধ

POST https://adsdatahub.googleapis.com/v1/{name=customers/*}:generateIvtReport

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
name

string

অ্যাডস ডেটা হাব গ্রাহক অনুরোধ করছেন। এটি 'গ্রাহক/[customerId]' আকারে। যেমন 'গ্রাহক/123'।

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

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "adsDataCustomerId": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "timeZone": string,
  "destTable": string,

  // Union field platform_dimensions can be only one of the following:
  "googleAdsDimensions": {
    object (GoogleAdsDimensions)
  },
  "dv360YoutubeDimensions": {
    object (Dv360Dimensions)
  },
  "ytReserveDimensions": {
    object (YouTubeReserveDimensions)
  }
  // End of list of possible types for union field platform_dimensions.
}
ক্ষেত্র
adsDataCustomerId

string ( int64 format)

লিঙ্ক করা বিজ্ঞাপন ডেটা হাব গ্রাহক আইডি যা বিজ্ঞাপন ডেটার মালিক।

startDate

object ( Date )

প্রতিবেদন তৈরির প্রথম দিন।

endDate

object ( Date )

উত্পন্ন প্রতিবেদনের শেষ দিন, অন্তর্ভুক্ত.

timeZone

string

ঐচ্ছিক। রিপোর্টের শুরু এবং শেষ তারিখের জন্য সময় অঞ্চল। নির্দিষ্ট করা না থাকলে, 'UTC'-তে ডিফল্ট।

destTable

string

'project.dataset.table_name' ফর্ম্যাট সহ ক্যোয়ারী ফলাফলের জন্য গন্তব্য BigQuery টেবিল। নির্দিষ্ট করা থাকলে, প্রকল্পটি গ্রাহকের ADH অ্যাকাউন্টের জন্য স্পষ্টভাবে সাদা তালিকাভুক্ত হতে হবে। যদি প্রজেক্ট নির্দিষ্ট করা না থাকে, প্রদত্ত গ্রাহকের জন্য ডিফল্ট প্রকল্প ব্যবহার করে। যদি প্রকল্প বা ডেটাসেট কোনোটিই নির্দিষ্ট করা না থাকে, তাহলে ডিফল্ট প্রকল্প এবং ডেটাসেট ব্যবহার করে।

ইউনিয়ন ফিল্ড platform_dimensions । ঐচ্ছিক প্ল্যাটফর্ম-নির্দিষ্ট স্লাইসিংয়ের সাথে রিপোর্ট করার প্ল্যাটফর্ম। একটি প্ল্যাটফর্ম নির্বাচন না করার ফলে একটি ত্রুটি হবে৷ platform_dimensions নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
googleAdsDimensions

object ( GoogleAdsDimensions )

প্ল্যাটফর্ম Google বিজ্ঞাপনে রিপোর্ট করুন।

dv360YoutubeDimensions

object ( Dv360Dimensions )

প্ল্যাটফর্ম DV360 এ রিপোর্ট করুন।

ytReserveDimensions

object ( YouTubeReserveDimensions )

প্ল্যাটফর্ম YTR-এ রিপোর্ট করুন।

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

সফল হলে, প্রতিক্রিয়া বডিতে Operation একটি উদাহরণ থাকে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/adsdatahub

GoogleAds মাত্রা

Google বিজ্ঞাপন প্ল্যাটফর্মের জন্য ফিল্টারিং মাত্রা।

JSON প্রতিনিধিত্ব
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
ক্ষেত্র
campaignIds[]

string ( int64 format)

ঐচ্ছিক Google বিজ্ঞাপন প্রচার আইডি। খালি থাকলে, নির্দিষ্ট সময়ের জন্য সমস্ত প্রচারাভিযানের রিপোর্ট।

metricType

enum ( MetricType )

পরিমাপ এবং রিপোর্ট করার জন্য প্ল্যাটফর্ম মনোনীত করে।

মেট্রিক টাইপ

পরিমাপ এবং রিপোর্ট করার জন্য প্ল্যাটফর্ম মনোনীত করে।

এনামস
METRIC_TYPE_UNSPECIFIED অনির্দিষ্ট মেট্রিক প্রকার।
METRIC_TYPE_IMPRESSION Google বিজ্ঞাপন ইম্প্রেশন ডেটা।
METRIC_TYPE_YOUTUBE_VIEW YouTube ভিউ ওরফে TrueView ভিউ।

Dv360 মাত্রা

DV360 প্ল্যাটফর্মের জন্য ফিল্টারিং মাত্রা।

JSON প্রতিনিধিত্ব
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
ক্ষেত্র
lineItemIds[]

string ( int64 format)

ঐচ্ছিক DV360 লাইন আইটেম আইডি। খালি থাকলে, নির্দিষ্ট সময়ের জন্য সমস্ত লাইন আইটেমের রিপোর্ট।

metricType

enum ( MetricType )

পরিমাপ এবং রিপোর্ট করার জন্য প্ল্যাটফর্ম মনোনীত করে।

YouTube রিজার্ভ মাত্রা

YouTube রিজার্ভ প্ল্যাটফর্মের জন্য ফিল্টারিং মাত্রা।

JSON প্রতিনিধিত্ব
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
ক্ষেত্র
orderIds[]

string ( int64 format)

ঐচ্ছিক YouTube রিজার্ভ অর্ডার আইডি। খালি থাকলে, নির্দিষ্ট সময়ের জন্য সমস্ত অর্ডারের রিপোর্ট।

metricType

enum ( MetricType )

পরিমাপ এবং রিপোর্ট করার জন্য প্ল্যাটফর্ম মনোনীত করে।