Method: accounts.hotels.setLiveOnGoogle
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طريقة مخصّصة على مستوى المجموعة لتعديل حالة "مباشر على Google" لمواقع متعددة. يمكن لكل مكالمة تفعيل أو إيقاف فنادق متعددة. لتفعيل بعض الفنادق وإيقاف بعض الفنادق، عليك إجراء عدة مكالمات.
طلب HTTP
POST https://travelpartner.googleapis.com/v3/{account=accounts/*}/hotels:setLiveOnGoogle
يستخدم عنوان URL بنية gRPC Transcoding.
معلّمات المسار
| المَعلمات |
account |
string
مطلوبة. اسم المورد للحساب. التنسيق هو accounts/{account_id}.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"liveOnGoogle": boolean,
"partnerHotelIds": [
string
]
} |
| الحقول |
liveOnGoogle |
boolean
مطلوبة. ما إذا كان الموقع الإلكتروني سيظهر على Google وفي حال ضبط هذه السياسة على "صحيح"، سيعرض محرّك البحث Google المواقع الإلكترونية إذا اكتملت عملية التكامل وكان الموقع الإلكتروني متاحًا. وفي حال ضبطها على "خطأ"، لن يعرض محرك البحث Google الخصائص مطلقًا.
|
partnerHotelIds[] |
string
مطلوبة. تحدِّد المواقع المطلوب تحديثها باستخدام إعداد LiveOnGoogle.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"updatedHotelIds": [
string
],
"failedHotelIds": [
string
]
} |
| الحقول |
updatedHotelIds[] |
string
يحدِّد السمات المعدَّلة.
|
failedHotelIds[] |
string
تحديد المواقع التي لا يمكن لشركة Google تعديلها.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/travelpartner
للحصول على مزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على OAuth 2.0.
جميع الحقوق محفوظة. إنّ Java علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2022-08-23 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2022-08-23 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis method allows you to update the "Live on Google" status for multiple hotel properties, enabling or disabling their visibility on Google.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify whether to show or hide properties on Google using the \u003ccode\u003eliveOnGoogle\u003c/code\u003e boolean field in the request body.\u003c/p\u003e\n"],["\u003cp\u003eThe request body also requires a list of \u003ccode\u003epartnerHotelIds\u003c/code\u003e to identify the specific properties to update.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes lists of successfully updated (\u003ccode\u003eupdatedHotelIds\u003c/code\u003e) and failed (\u003ccode\u003efailedHotelIds\u003c/code\u003e) hotel properties.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/travelpartner\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.hotels.setLiveOnGoogle\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SetLiveOnGoogleResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nCollection-level custom method to update the Live on Google status for multiple properties. Each call can turn on or off multiple hotels. To turn some hotels on and turn some hotels off, you will have to make multiple calls.\n\n### HTTP request\n\n`POST https://travelpartner.googleapis.com/v3/{account=accounts/*}/hotels:setLiveOnGoogle`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|-------------------------------------------------------------------------------------------|\n| `account` | `string` Required. The resource name of the account. The format is accounts/{account_id}. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"liveOnGoogle\": boolean, \"partnerHotelIds\": [ string ], \"liveOnGoogleStatus\": enum (/hotels/hotel-prices/api-reference/rest/v3/accounts.hotelViews#LiveOnGoogleStatus) } ``` |\n\n| Fields ||\n|---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `liveOnGoogle` **(deprecated)** | `boolean` Optional. DEPRECATED. Whether the property will show on Google. When true, Google will show the properties if their integration is complete and the property is available. When false, Google will never show the properties. Superseded by `liveOnGoogleStatus`. Only one of `liveOnGoogle` or `liveOnGoogleStatus` should be set; if both are set, `liveOnGoogleStatus` will be used. |\n| `partnerHotelIds[]` | `string` Required. Identifies the properties to update with the liveOnGoogle setting. |\n| `liveOnGoogleStatus` | `enum (`[LiveOnGoogleStatus](/hotels/hotel-prices/api-reference/rest/v3/accounts.hotelViews#LiveOnGoogleStatus)`)` Optional. Whether the property will show on Google, with more granular controls than the original `liveOnGoogle` boolean field. Only one of `liveOnGoogle` or `liveOnGoogleStatus` should be set; if both are set, `liveOnGoogleStatus` will be used. **Note:** This field should be enclosed in quotes. For example, `\"LIVE_ON_GOOGLE_STATUS_INACTIVE\"`. |\n\n### Response body\n\nResponse message for [HotelService.SetLiveOnGoogle](/hotels/hotel-prices/api-reference/rest/v3/accounts.hotels/setLiveOnGoogle#google.travel.travelpartner.v3.HotelService.SetLiveOnGoogle).\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------|\n| ``` { \"updatedHotelIds\": [ string ], \"failedHotelIds\": [ string ] } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------|\n| `updatedHotelIds[]` | `string` Identifies the updated properties. |\n| `failedHotelIds[]` | `string` Identifies properties that Google could not update. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/travelpartner`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
