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
]
} |
필드 |
liveOnGoogle |
boolean
필수 항목입니다. Google에 속성을 표시할지 여부 True로 설정하면 통합이 완료되고 속성을 사용할 수 있는 경우 속성이 표시됩니다. false인 경우 Google에서는 속성을 표시하지 않습니다.
|
partnerHotelIds[] |
string
필수 항목입니다. liveOnGoogle 설정으로 업데이트할 속성을 식별합니다.
|
응답 본문
성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
{
"updatedHotelIds": [
string
],
"failedHotelIds": [
string
]
} |
필드 |
updatedHotelIds[] |
string
업데이트된 속성을 식별합니다.
|
failedHotelIds[] |
string
Google에서 업데이트할 수 없는 속성을 식별합니다.
|
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/travelpartner
자세한 내용은 OAuth 2.0 개요를 참고하세요.
All rights reserved. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2022-08-23(UTC)
[null,null,["최종 업데이트: 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)."]]