Method: partners.channels.sites.replace

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

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

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

طلب HTTP

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

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

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

المَعلمات
channelId

string (int64 format)

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

string (int64 format)

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

نص الطلب

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

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

  // Union field owner can be only one of the following:
  "advertiserId": 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.