Method: advertisers.channels.sites.bulkEdit

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

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

طلب HTTP

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit

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

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

المعلمات
channelId

string (int64 format)

مطلوب. معرّف القناة الرئيسية التي تنتمي إليها المواقع الإلكترونية
معلمة الاتحاد owner. مطلوب. يحدّد كيان "مساحة العرض والفيديو 360" الذي يملك القناة الرئيسية. يمكن أن يكون شريكًا أو معلِنًا. يمكن أن يكون owner واحدًا فقط مما يلي:
advertiserId

string (int64 format)

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

نص الطلب

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

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

  // Union field owner can be only one of the following:
  "partnerId": string
  // End of list of possible types for union field owner.
}
الحقول
deletedSites[]

string

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

object (Site)

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

string (int64 format)

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

string (int64 format)

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

نص الاستجابة

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

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

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

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

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.