Method: advertisers.channels.sites.replace

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

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

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

طلب HTTP

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

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

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

المعلمات
channelId

string (int64 format)

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

string (int64 format)

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

نص الطلب

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

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

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

object (Site)

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

string (int64 format)

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

string (int64 format)

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

نص الاستجابة

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

نطاقات التفويض

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

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

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