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

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

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

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

درخواست‌ها

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

آدرس‌های اینترنتی درخواست 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
  • لینک به پروفایل تجاری گوگل : POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • ایجاد یک حساب کاربری (لینک تجمیع حساب) : POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

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

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

روش‌ها

API محتوا برای روش خرید روش 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 از این روش اختصاصی برای پیوند دادن حساب مرکز بازرگانان به نمایه تجاری گوگل استفاده کنید.
accounts.update (با adsLinks ) منبع AccountRelationship Linking to Google Ads is managed from the Google Ads UI. The resulting link is represented as an AccountRelationship in Merchant API, which can be viewed but not created directly.

تغییرات جزئی فیلدها

API محتوا برای خرید رابط برنامه‌نویسی کاربردی (API) فروشنده توضیحات
AccountsLinkRequest.action propose ، approve ، reject روش‌ها فیلد تک‌عملی با متدهای API اختصاصی برای هر تغییر وضعیت action چرخه حیات سرویس جایگزین می‌شود.
AccountsLinkRequest.linkType AccountService.service_type رشته‌ی عمومی linkType با یک فیلد ساختاریافته‌ی service_type oneof در منبع 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 لینک‌های گوگل ادز به عنوان یک منبع AccountRelationship نمایش داده می‌شوند که در آن provider providers/GOOGLE_ADS است. این رابطه معمولاً از رابط کاربری گوگل ادز مدیریت می‌شود.