تستبدل جميع المواقع الإلكترونية ضمن قناة واحدة.
ستؤدي العملية إلى استبدال المواقع الإلكترونية ضمن قناة بالمواقع الإلكترونية المقدّمة في ReplaceSitesRequest.new_sites
.
تتطلّب هذه الطريقة وقت استجابة طويلاً بانتظام. نقترح عليك زيادة المهلة التلقائية لتجنُّب حدوث أخطاء.
طلب HTTP
POST https://displayvideo.googleapis.com/v3/partners/{partnerId}/channels/{channelId}/sites:replace
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
channelId |
مطلوبة. رقم تعريف القناة الرئيسية التي سيتم استبدال مواقعها الإلكترونية |
معلمة الاتحاد owner . مطلوبة. تحدّد كيان "مساحة العرض والفيديو 360" الذي يملك القناة الرئيسية. قد يكون إما شريكًا أو معلنًا. يمكن أن يكون الحقل "owner " واحدًا فقط مما يلي: |
|
partnerId |
رقم تعريف الشريك الذي يملك القناة الرئيسية. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "newSites": [ { object ( |
الحقول | |
---|---|
newSites[] |
المواقع الإلكترونية التي ستحلّ محل المواقع الإلكترونية الحالية التي تم تعيينها إلى القناة، والمحددة كقائمة تضم |
حقل الاتحاد owner مطلوبة. تحدّد كيان "مساحة العرض والفيديو 360" الذي يملك القناة الرئيسية. قد يكون إما شريكًا أو معلنًا. يمكن أن يكون الحقل "owner " واحدًا فقط مما يلي: |
|
partnerId |
رقم تعريف الشريك الذي يملك القناة الرئيسية. |
advertiserId |
رقم تعريف المعلِن الذي يملك القناة الرئيسية. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال ReplaceSitesResponse
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.