Method: partners.channels.sites.replace

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

سيؤدي هذا الإجراء إلى استبدال المواقع الإلكترونية ضِمن قناة بالمواقع الإلكترونية المقدَّمة في ReplaceSitesRequest.new_sites.

يحدث تأخير كبير في هذا الإجراء بشكل منتظم. ننصحك بزيادة المهلة التلقائية لتجنُّب حدوث أخطاء.

طلب HTTP

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

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

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

المعلمات
channelId

string (int64 format)

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

string (int64 format)

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

نص الطلب

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

تمثيل JSON 
{
  "newSites": [
    {
      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.
}
الحقول
newSites[]

object (Site)

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

string (int64 format)

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

string (int64 format)

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

نص الاستجابة

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

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

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

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

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