Method: accounts.brands.patch
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یک برند را به روز می کند.
درخواست HTTP
PATCH https://travelpartner.googleapis.com/v3/{brand.name=accounts/*/brands/*}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های |
---|
brand.name | string نام منبع برای نام تجاری در قالب accounts/{account_id}/brands/{brandId} . brandId باید با شناسه برند شریک مورد استفاده برای تطبیق صفحه فرود و استفاده در فهرست دارایی مطابقت داشته باشد. |
پارامترهای پرس و جو
مولفه های |
---|
updateMask | string ( FieldMask format) ضروری. زمینه به روز رسانی. فقط فیلدهای displayNames و icon_id را می توان به روز کرد. از نحو نشان داده شده در مثال URI زیر استفاده کنید و مقدار جدید را در بدنه درخواست ارائه دهید. نمونه درخواست URI و بدنه درخواست: PATCH https://travelpartner.googleapis.com/v3/accounts/123456789/
brands/my-brand?updateMask=brand.display_names
{
"displayNames": [{
"language": "en"
"text": "Gilles' Gites"
}]
}
اطلاعات بالا برای تشکیل URI و بدنه درخواست کافی است. جمله زیر اطلاعات تکمیلی و تولید خودکار در مورد فرمت FieldMask به طور کلی است. این فهرستی از نامهای فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" . |
درخواست بدن
بدنه درخواست شامل نمونه ای از Brand
است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Brand
است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/travelpartner
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
کلیه حقوق محفوظ است. Java علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2022-08-23 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2022-08-23 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]