Method: accounts.hotels.setLiveOnGoogle
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Phương thức tùy chỉnh cấp bộ sưu tập để cập nhật trạng thái của chế độ Xuất hiện trên Google của nhiều cơ sở lưu trú. Mỗi cuộc gọi có thể bật hoặc tắt nhiều khách sạn. Để bật và tắt một số khách sạn, bạn sẽ phải thực hiện nhiều cuộc gọi.
Yêu cầu HTTP
POST https://travelpartner.googleapis.com/v3/{account=accounts/*}/hotels:setLiveOnGoogle
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Các tham số |
account |
string
Bắt buộc. Tên tài nguyên. Định dạng là accounts/{account_id}.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"liveOnGoogle": boolean,
"partnerHotelIds": [
string
]
} |
| Các trường |
liveOnGoogle |
boolean
Bắt buộc. Cơ sở lưu trú có xuất hiện trên Google hay không. Khi bạn đặt giá trị thành đúng, Google sẽ hiển thị các cơ sở lưu trú đó nếu quá trình tích hợp của họ đã hoàn tất và cơ sở lưu trú đã sẵn sàng để sử dụng. Khi giá trị này là false, Google sẽ không bao giờ hiển thị các thuộc tính này.
|
partnerHotelIds[] |
string
Bắt buộc. Xác định các thuộc tính cần cập nhật bằng chế độ cài đặt liveOnGoogle.
|
Nội dung phản hồi
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"updatedHotelIds": [
string
],
"failedHotelIds": [
string
]
} |
| Các trường |
updatedHotelIds[] |
string
Xác định các thuộc tính mới.
|
failedHotelIds[] |
string
Xác định các cơ sở lưu trú mà Google không thể cập nhật.
|
Phạm vi cấp phép
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/travelpartner
Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
Mọi quyền được bảo lưu. Java là một nhãn hiệu đã đăng ký của Oracle và/hoặc chi nhánh của Oracle.
Cập nhật lần gần đây nhất: 2022-08-23 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2022-08-23 UTC."],[[["\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)."]]
