Method: accounts.brands.patch

یک برند را به‌روزرسانی می‌کند.

درخواست HTTP

PATCH https://travelpartner.googleapis.com/v3/{brand.name=accounts/*/brands/*}

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
brand.name

string

فقط خروجی. نام منبع برای برند در قالب accounts/{account_id}/brands/{brandId} . شناسه brandId با شناسه برند شریک که برای تطبیق صفحه فرود استفاده می‌شود و شناسه برند در سطح ویژگی مطابقت دارد.

یک برند پیش‌فرض به ویژگی‌هایی که برند ندارند اعمال می‌شود. brandId برند پیش‌فرض NO_BRAND_ID است. می‌توان آن را مانند هر برند پیکربندی‌شده دیگری دریافت و به‌روزرسانی کرد.

پارامترهای پرس و جو

پارامترها
updateMask

string ( FieldMask format)

الزامی. فیلدی که باید به‌روزرسانی شود. فقط فیلدهای displayNames و icon می‌توانند به‌روزرسانی شوند. از سینتکس نشان داده شده در مثال 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" .

allowMissing

boolean

وقتی مقدار true باشد و نام تجاری (Brand) پیدا نشود، یک نام تجاری جدید ایجاد می‌شود. در این شرایط، updateMask نادیده گرفته می‌شود.

درخواست بدنه

بدنه درخواست شامل نمونه‌ای از Brand است.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از Brand است.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/travelpartner

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .