انتقال پیوند حساب

مدیریت روابط حساب‌ها از یک روش link واحد در Content API برای خرید به یک سیستم دقیق‌تر و واضح‌تر در Merchant API تبدیل شده است. API جدید از منابع اختصاصی مانند AccountRelationship و AccountService برای تعریف خدمات خاصی که یک حساب به حساب دیگر ارائه می دهد استفاده می کند. برای جزئیات بیشتر، به روابط بین حساب ها مراجعه کنید.

تفاوت های کلیدی

  • منابع اختصاصی برای روابط و خدمات : در Merchant API، منبع AccountRelationship ارتباط بین ارائه‌دهنده خدمات و تاجر را تعریف می‌کند، در حالی که منبع AccountService خدمات دقیق ارائه شده را مشخص می‌کند (به عنوان مثال accountAggregation ). این جایگزین فیلدهای linkType و services عمومی از Content API برای خرید می‌شود.
  • روش‌های اقدام صریح : به جای یک روش link واحد با پارامتر action ، Merchant API از روش‌های متمایز برای مدیریت سرویس‌ها مانند propose ، approve و reject استفاده می‌کند.
  • پیوند اختصاصی نمایه کسب‌وکار Google : پیوند دادن به نمایه کسب‌وکار Google، که قبلاً با تنظیم فیلد googleMyBusinessLink انجام می‌شد، اکنون یک روش اختصاصی دارد، gbpAccounts.linkGbpAccount .
  • ایجاد حساب مشتری به عنوان یک سرویس : ایجاد یک حساب مشتری تحت یک حساب پیشرفته اکنون به عنوان پیشنهاد یک سرویس accountAggregation با استفاده از روش accounts.createAndConfigure تلقی می شود. اطلاعات بیشتر درباره حساب‌ها در صفحه API حساب‌های تجاری موجود است. نیازی به دست دادن نیست، زیرا کاربر به حساب پیشرفته و حساب مشتری دسترسی دارد.

درخواست ها

Merchant API نقاط پایانی خاصی را برای مدیریت انواع مختلف پیوندها و خدمات حساب فراهم می کند:

URL های درخواست Merchant API

  • یک سرویس جدید پیشنهاد کنید : POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • تأیید یک سرویس : POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • رد کردن یک سرویس : POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • پیوند به نمایه کسب و کار Google : POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • ایجاد یک حساب مشتری (لینک تجمع حساب) : POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

درخواست مقایسه URL

درخواست توضیحات Content API برای خرید Merchant API
پیوند حساب ها (به عنوان مثال، سیستم عامل های شخص ثالث) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
پیوند به نمایه کسب و کار Google PUT .../v2.1/{merchantId}/accounts/{accountId} (با فیلد googleMyBusinessLink ) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
یک حساب مشتری ایجاد کنید POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

روش ها

Content API برای روش خرید روش Merchant API در دسترس بودن و یادداشت ها
accounts.link accountServices.propose از این روش برای راه اندازی یک سرویس جدید با حساب دیگری استفاده کنید.
accounts.link (با action: "approve" ) accountServices.approve از این روش برای تأیید پیشنهاد خدمات معلق استفاده کنید.
accounts.link (با action: "remove" ) accountServices.reject از این روش برای رد یک سرویس معلق یا تاسیس شده استفاده کنید.
accounts.insert (برای حساب های مشتری) accounts.createAndConfigure از این روش با یک سرویس accountAggregation برای ایجاد یک حساب مشتری جدید تحت یک حساب پیشرفته استفاده کنید.
accounts.update (با googleMyBusinessLink ) gbpAccounts.linkGbpAccount از این روش اختصاصی برای پیوند دادن حساب Merchant Center به نمایه کسب و کار Google استفاده کنید.
accounts.update (با adsLinks ) منبع AccountRelationship پیوند به Google Ads از رابط کاربری Google Ads مدیریت می شود. پیوند حاصل به‌عنوان یک AccountRelationship در Merchant API نشان داده می‌شود که می‌توان آن را مشاهده کرد اما مستقیماً ایجاد نمی‌شود.

تغییرات میدان دقیق

Content API برای خرید Merchant API توضیحات
AccountsLinkRequest.action propose ، approve ، reject روش برای هر تغییر وضعیت در چرخه عمر سرویس، فیلد action واحد با روش‌های API اختصاصی جایگزین می‌شود.
AccountsLinkRequest.linkType AccountService.service_type رشته linkType عمومی با یک فیلد ساختاریافته service_type one of در منبع AccountService ، مانند productsManagement یا accountAggregation جایگزین می‌شود.
AccountsLinkRequest.services AccountService.service_type لیست خدمات مبتنی بر رشته اکنون با service_type خاصی که در منبع AccountService انتخاب شده است نشان داده می شود.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider اکنون شناسه حساب ارائه دهنده خدمات در قسمت provider درخواست propose مشخص شده است.
Account.googleMyBusinessLink LinkGbpAccountRequest شی حاوی جزئیات پیوند GBP با یک پیام درخواست اختصاصی برای روش linkGbpAccount جایگزین می شود.
Account.adsLinks AccountRelationship پیوندهای Google Ads به عنوان یک منبع AccountRelationship نشان داده می شوند که provider آن providers/GOOGLE_ADS است. این رابطه معمولاً از رابط کاربری Google Ads مدیریت می‌شود.