Method: customers.describeValidDv360AdvertiserIds

وصف أرقام تعريف المعلنين الصالحة في "مساحة العرض والفيديو 360"

طلب HTTP

POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:describeValidDv360AdvertiserIds

يستخدم عنوان URL بنية gRPC Transcoding.

معلّمات المسار

المَعلمات
customer

string

مطلوبة. اسم مورد العميل، مثل 'customers/123'.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "adsDataCustomerId": string,
  "dv360PartnerId": string,
  "pageSize": integer,
  "pageToken": string
}
الحقول
adsDataCustomerId

string (int64 format)

مطلوبة. بيانات أداء الإعلانات التي يملكها العميل (الرقم التعريفي للعميل)، مثل 456.
dv360PartnerId

string (int64 format)

مطلوبة. الرقم التعريفي للشريك في "مساحة العرض والفيديو 360" الذي تم طلب أرقام تعريف المعلنين الخاصة به، مثل 1234
pageSize

integer

الحد الأقصى لعدد السلع التي يمكن إرجاعها. إذا لم يتم إدخال أي قيم، سيحدد الخادم عدد العملاء المرتبطين للعرض.
pageToken

string

الرمز المميز للصفحة، الذي يتم عرضه من خلال مكالمة سابقة، يُستخدم لطلب الصفحة التالية من النتائج، إن وجدت.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

الاستجابة لـ DeDescriptionvalidDV360AdvertiserIdsRequest

تمثيل JSON 
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "nextPageToken": string
}
الحقول
entities[]

object (Entity)

قائمة الكيانات، يصف كل منها معلِنًا في "مساحة العرض والفيديو 360"
nextPageToken

string

رمز مميز يمكن استخدامه لطلب صفحة النتائج التالية. ويكون هذا الحقل فارغًا في حال عدم توفّر نتائج إضافية.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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