Method: accounts.brands.patch
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.
Yêu cầu HTTP
PATCH https://travelpartner.googleapis.com/v3/{brand.name=accounts/*/brands/*}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số |
brand.name |
string
Tên tài nguyên cho thương hiệu theo định dạng accounts/{account_id}/brands/{brandId} . brandId phải khớp với mã nhận dạng thương hiệu của đối tác dùng để so khớp trang đích và dùng trong danh sách cơ sở lưu trú.
|
Tham số truy vấn
Các tham số |
updateMask |
string (FieldMask format)
Bắt buộc. Trường cần cập nhật. Chỉ có thể cập nhật các trường displayNames và icon_id . Hãy sử dụng cú pháp hiển thị trong URI mẫu bên dưới và cung cấp giá trị mới trong phần nội dung yêu cầu. Ví dụ về URI yêu cầu và nội dung yêu cầu:
PATCH https://travelpartner.googleapis.com/v3/accounts/123456789/
brands/my-brand?updateMask=brand.display_names
{
"displayNames": [{
"language": "en"
"text": "Gilles' Gites"
}]
}
Thông tin ở trên là đủ để tạo URI và nội dung yêu cầu. Câu dưới đây là thông tin bổ sung được tạo tự động về định dạng FieldMask nói chung. Đây là danh sách các trường có đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"
|
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của Brand
.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Brand
.
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\u003eUpdates an existing brand or creates a new one if it doesn't exist using a PATCH request.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the brand name in the URL path and the fields to update using \u003ccode\u003eupdateMask\u003c/code\u003e in the query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain the updated brand information in JSON format as defined by the \u003ccode\u003eBrand\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses will return the updated \u003ccode\u003eBrand\u003c/code\u003e object, and the request needs \u003ccode\u003ehttps://www.googleapis.com/auth/travelpartner\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.brands.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nUpdates a brand.\n\n### HTTP request\n\n`PATCH https://travelpartner.googleapis.com/v3/{brand.name=accounts/*/brands/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `brand.name` | `string` Output only. The resource name for the brand in the format `accounts/{account_id}/brands/{brandId}`. The `brandId` corresponds to the partner's brand identifier used for landing page matching and the property-level brand identifier. A default brand is applied to properties that do not have a brand. The `brandId` of the default brand is `NO_BRAND_ID`. It can be fetched and updated like any configured brand. |\n\n### Query parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. The field to update. Only the `displayNames` and `icon` fields can be updated. Use the syntax shown in the example URI below and provide the new value in the request body. Example request URI and request body: PATCH https://travelpartner.googleapis.com/v3/accounts/123456789/ brands/my-brand?updateMask=brand.display_names { \"displayNames\": [{ \"language\": \"en\" \"text\": \"Gilles' Gites\" }] } The information above is sufficient for forming the URI and request body. The sentence below is auto-generated, supplemental information about the `FieldMask` format in general. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `allowMissing` | `boolean` When true, and the Brand is not found, a new Brand will be created. In this situation, `updateMask` is ignored. |\n\n### Request body\n\nThe request body contains an instance of [Brand](/hotels/hotel-prices/api-reference/rest/v3/accounts.brands#Brand).\n\n### Response body\n\nIf successful, the response body contains an instance of [Brand](/hotels/hotel-prices/api-reference/rest/v3/accounts.brands#Brand).\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)."]]