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 Overview.