Method: advertisers.channels.sites.replace

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

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

تتسم هذه الطريقة عادةً بوقت استجابة طويل. ننصحك بزيادة المهلة التلقائية لتجنُّب الأخطاء.

طلب HTTP

POST https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/channels/{channelId}/sites:replace

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

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

المعلمات
channelId

string (int64 format)

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

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:
  "partnerId": 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.