Method: accounts.hotels.setLiveOnGoogle

طريقة مخصّصة على مستوى المجموعة لتعديل حالة "مباشر على Google" لعدة مواقع. يمكن تفعيل أو إيقاف فنادق متعددة في كل مكالمة. لتفعيل بعض الفنادق وإيقاف بعضها الآخر، عليك إجراء مكالمات متعددة.

طلب HTTP

POST https://travelpartner.googleapis.com/v3/{account=accounts/*}/hotels:setLiveOnGoogle

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

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

المعلمات
account

string

الحقل مطلوب. اسم المورد الخاص بالحساب يكون التنسيق على النحو التالي: accounts/{account_id}.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "liveOnGoogle": boolean,
  "partnerHotelIds": [
    string
  ],
  "liveOnGoogleStatus": enum (LiveOnGoogleStatus)
}
الحقول
liveOnGoogle
(deprecated)

boolean

اختياريّ. متوقّف تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار سيظهر على Google. عند ضبط القيمة على "صحيح"، ستعرض Google المؤسسات إذا اكتمل دمجها وكانت المؤسسة متاحة. عند ضبط القيمة على "خطأ"، لن تعرض Google الخصائص أبدًا.

حلَّ liveOnGoogleStatus محل هذا الإصدار.

يجب ضبط إحدى السمتَين liveOnGoogle أو liveOnGoogleStatus فقط. وفي حال ضبط كلتيهما، سيتم استخدام السمة liveOnGoogleStatus.
partnerHotelIds[]

string

الحقل مطلوب. تحدّد هذه السمة الخصائص التي سيتم تعديلها باستخدام الإعداد liveOnGoogle.
liveOnGoogleStatus

enum (LiveOnGoogleStatus)

اختياريّ. تحدّد هذه السمة ما إذا كان سيتم عرض الموقع على Google، مع توفير عناصر تحكّم أكثر دقة من الحقل المنطقي liveOnGoogle الأصلي.

يجب ضبط إحدى السمتَين liveOnGoogle أو liveOnGoogleStatus فقط. وفي حال ضبط كلتيهما، سيتم استخدام السمة liveOnGoogleStatus.

ملاحظة: يجب وضع هذا الحقل بين علامتَي اقتباس. مثلاً: "LIVE_ON_GOOGLE_STATUS_INACTIVE"

نص الاستجابة

رسالة الردّ على HotelService.SetLiveOnGoogle

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "updatedHotelIds": [
    string
  ],
  "failedHotelIds": [
    string
  ]
}
الحقول
updatedHotelIds[]

string

تحدّد هذه السمة الخصائص المعدَّلة.
failedHotelIds[]

string

تحدّد هذه السمة الخصائص التي تعذّر على Google تعديلها.

نطاقات الأذونات

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

  • https://www.googleapis.com/auth/travelpartner

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