Method: partners.channels.sites.bulkEdit

تعديل المواقع الإلكترونية بشكل مجمّع ضمن قناة واحدة

سيؤدي هذا الإجراء إلى حذف المواقع الإلكترونية المقدَّمة في BulkEditSitesRequest.deleted_sites ثم إنشاء المواقع الإلكترونية المقدَّمة في BulkEditSitesRequest.created_sites.

طلب HTTP

POST https://displayvideo.googleapis.com/v4/partners/{partnerId}/channels/{channelId}/sites:bulkEdit

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
channelId

string (int64 format)

الحقل مطلوب. رقم تعريف القناة الرئيسية التي تنتمي إليها المواقع الإلكترونية
الحقل مطلوب. تحدّد هذه السمة عنصر "مساحة العرض والفيديو 360" الذي يملك القناة الرئيسية. ويمكن أن يكون شريكًا أو معلنًا. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
partnerId

string (int64 format)

رقم تعريف الشريك الذي يملك القناة الرئيسية
نهاية الحقول التي يستبعد كلّ منها الآخر

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "deletedSites": [
    string
  ],
  "createdSites": [
    {
      object (Site)
    }
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "advertiserId": string
  // End of mutually exclusive fields.
}
الحقول
deletedSites[]

string

المواقع الإلكترونية المطلوب حذفها بشكل مجمّع، ويتم تحديدها كقائمة من المواقع الإلكترونية url_or_app_ids.
createdSites[]

object (Site)

المواقع الإلكترونية التي سيتم إنشاؤها بشكل مجمّع، ويتم تحديدها كقائمة من Sites
الحقل مطلوب. تحدّد هذه السمة عنصر "مساحة العرض والفيديو 360" الذي يملك القناة الرئيسية. ويمكن أن يكون شريكًا أو معلنًا. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
partnerId

string (int64 format)

رقم تعريف الشريك الذي يملك القناة الرئيسية
advertiserId

string (int64 format)

رقم تعريف المعلِن الذي يملك القناة الرئيسية
نهاية الحقول التي يستبعد كلّ منها الآخر

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال BulkEditSitesResponse.

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

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

  • https://www.googleapis.com/auth/display-video

لمزيد من المعلومات، راجِع OAuth 2.0 Overview.