انتقال مدیریت حساب

Accounts API به مجموعه‌ای از منابع تقسیم می‌شود تا امکان مدیریت کارآمدتر حساب‌های Merchant Center شما را با کنترل دقیق‌تر بر جنبه‌های مختلف حسابتان فراهم کند.

این راهنما تغییرات کلیدی را توضیح می‌دهد و به شما کمک می‌کند ادغام مدیریت حساب موجود خود را از Content API for Shopping به Merchant API منتقل کنید.

از یک منبع به چند منبع

در Content API for Shopping، منبع Account یک شیء یکپارچه بود که همه چیز را از نام حساب و نشانی وب‌سایت گرفته تا فهرست‌های کاربر و اطلاعات کسب‌وکار دربرمی‌گرفت.

Merchant API این را به چندین منبع کوچک‌تر و متمرکزتر تقسیم می‌کند. این تغییر امکان تماس‌های هدفمندتر و کارآمدتر با میانای برنامه‌سازی کاربردی را فراهم می‌کند. برای مثال، برای به‌روزرسانی فقط نشانی کسب‌وکارتان، اکنون به‌جای به‌روزرسانی کل شیء Account، درخواست PATCH به منبع BusinessInfo ارسال می‌کنید.

در اینجا خلاصه‌ای از نحوه نگاشت مفاهیم از منبع Content API for Shopping Account به منابع جدید در Merchant API آورده شده است:

قابلیت‌های جدید

Merchant API همچنین قابلیت‌های جدیدی را برای مدیریت حساب معرفی می‌کند که در Content API ویژه Shopping دردسترس نبودند:

  • شرایط خدمات: بازیابی و پذیرش برنامه‌ای «شرایط خدمات» بااستفاده از منابع TermsOfService و TermsOfServiceAgreementState.
  • ایجاد حساب: روش accounts.createAndConfigure اکنون از ایجاد حساب با روابط (مانند accountManagement)، تنظیم alias، و متوقف کردن درستی‌سنجی ایمیل بااستفاده از فیلد user.verificationMailSettings.verificationMailMode به‌نفع درستی‌سنجی مبتنی بر میانای برنامه‌سازی کاربردی بااستفاده از روش جدید accounts.verifySelf پشتیبانی می‌کند.
  • دسترسی به حساب با نام مستعار: دسترسی به حساب‌ها بااستفاده از قالب providerId~accountAlias، که روشی یکپارچه برای کسب‌وکارهایی که چندین حساب را مدیریت می‌کنند فراهم می‌کند تا از شناسه‌های حساب خودشان استفاده کنند.

درخواست‌ها

این جدول مقایسه‌ای تلفیقی از نشانی‌های وب درخواست برای کارهای رایج مدیریت حساب بین Content API for Shopping و Merchant API ارائه می‌دهد.

شرح درخواست Content API for Shopping میانای برنامه‌سازی کاربردی فروشنده
دریافت حساب GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
دریافت حساب با نام مستعار مستقیماً دردسترس نیست GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}~{alias}
فهرست کردن حساب‌های فرعی GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}:listSubaccounts
ایجاد حساب فرعی POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure
به‌روزرسانی داده‌های حساب PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} PATCH در منبع مناسب. برای مثال، برای به‌روزرسانی نام حساب: PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
حذف حساب فرعی DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
ادعای مالکیت وب‌سایت POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/homepage:claim
پیوند دادن حساب‌ها POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/link POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/services:propose

مدیریت اطلاعات اصلی حساب

منبع Account در Merchant API حاوی جزئیات ضروری حساب Merchant Center است، مانند نام، شناسه، و تنظیمات اصلی آن.

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

شرح درخواست Content API for Shopping میانای برنامه‌سازی کاربردی فروشنده
دریافت جزئیات حساب GET /content/v2.1/{merchantId}/accounts/{accountId} (دسترسی به مشخصه‌های اصلی مثل name، adult_content) GET /accounts/v1/accounts/{account}
ایجاد حساب فرعی POST /content/v2.1/{merchantId}/accounts POST /accounts/v1/accounts:createAndConfigure
به‌روزرسانی جزئیات حساب PUT /content/v2.1/{merchantId}/accounts/{accountId} (درحال به‌روزرسانی مشخصه‌های اصلی) PATCH /accounts/v1/accounts/{account}
حذف کردن حساب فرعی DELETE /content/v2.1/{merchantId}/accounts/{accountId} DELETE /accounts/v1/accounts/{account}

مقایسه دقیق فیلدها

میانای برنامه‌سازی کاربردی محتوا برای خرید (Account) Merchant API (Account) یادداشت‌ها
id account_id شناسه عددی اکنون فیلدی فقط خروجی است. شناسه اصلی منبع name است.
name account_name نام قابل‌خواندن برای انسان حساب.
language language_code نام فیلد اکنون language_code است.

مدیریت اطلاعات کسب‌وکار

از منبع BusinessInfo برای مدیریت اطلاعات عمومی درباره کسب‌وکارتان، مثل نشانی و مخاطبین خدمات مشتری، استفاده کنید. این جایگزین شیء businessInformation در «میانای برنامه‌سازی کاربردی محتوا برای خرید» می‌شود.

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

شرح درخواست Content API for Shopping میانای برنامه‌سازی کاربردی فروشنده
دریافت اطلاعات کسب‌وکار GET /content/v2.1/{merchantId}/accounts/{accountId} (دسترسی به مشخصه business_information) GET /accounts/v1/accounts/{account}/businessInfo
به‌روزرسانی اطلاعات کسب‌وکار PUT /content/v2.1/{merchantId}/accounts/{accountId} (درحال به‌روزرسانی مشخصه business_information) PATCH /accounts/v1/accounts/{account}/businessInfo

مقایسه دقیق فیلدها

میانای برنامه‌سازی کاربردی محتوا برای خرید (business_information) Merchant API (BusinessInfo) یادداشت‌ها
phone_number phone اکنون فیلد phone است و از google.type.PhoneNumber استفاده می‌کند.
customer_service.url customer_service.uri نام فیلد اکنون uri است.

مدیریت صفحه اصلی

برای مدیریت نشانی وب‌سایت فروشگاهتان و انجام درستی‌سنجی و ادعای مالکیت، از منبع Homepage استفاده کنید. این جایگزین فیلد websiteUrl و روش accounts.claimwebsite از Content API for Shopping می‌شود.

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

شرح درخواست Content API for Shopping میانای برنامه‌سازی کاربردی فروشنده
دریافت نشانی وب صفحه اصلی GET /content/v2.1/{merchantId}/accounts/{accountId} (دسترسی به مشخصه website_url) GET /accounts/v1/accounts/{account}/homepage
به‌روزرسانی نشانی وب صفحه اصلی PUT /content/v2.1/{merchantId}/accounts/{accountId} (درحال به‌روزرسانی مشخصه website_url) PATCH /accounts/v1/accounts/{account}/homepage
ادعای مالکیت صفحه اصلی POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
لغو ادعای مالکیت صفحه اصلی دردسترس نیست POST /accounts/v1/accounts/{account}/homepage:unclaim

مقایسه دقیق فیلدها

میانای برنامه‌سازی کاربردی محتوا برای خرید (Account) Merchant API (Homepage) یادداشت‌ها
website_url uri نشانی وب صفحه اصلی فروشگاه.
مستقیماً دردسترس نیست claimed فیلد بولی که اگر صفحه اصلی ادعای مالکیت شده باشد، true است.

مدیریت کاربران

منبع User به شما امکان می‌دهد افرادی را که می‌توانند به حساب Merchant Center دسترسی داشته باشند مدیریت کنید. این جایگزین آرایه users در منبع Account می‌شود. تفاوت اصلی در فرایند ایجاد کاربر است. در Merchant API، افزودن کاربر باعث ارسال دعوت می‌شود. کاربر باید دعوت را بپذیرد تا بتواند به حساب دسترسی پیدا کند.

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

شرح درخواست Content API for Shopping میانای برنامه‌سازی کاربردی فروشنده
فهرست کردن کاربران GET /content/v2.1/{merchantId}/accounts/{accountId} (دسترسی به مشخصه users) GET /accounts/v1/accounts/{account}/users
ایجاد کاربر PUT /content/v2.1/{merchantId}/accounts/{accountId} (درحال به‌روزرسانی مشخصه users) POST /accounts/v1/accounts/{account}/users
به‌روزرسانی کاربر PUT /content/v2.1/{merchantId}/accounts/{accountId} (درحال به‌روزرسانی مشخصه users) PATCH /accounts/v1/accounts/{account}/users/{email}
حذف یک کاربر PUT /content/v2.1/{merchantId}/accounts/{accountId} (درحال به‌روزرسانی مشخصه users) DELETE /accounts/v1/accounts/{account}/users/{email}

مقایسه دقیق فیلدها

میانای برنامه‌سازی کاربردی محتوا برای خرید (شیء آرایه users) Merchant API (User resource) یادداشت‌ها
email_address name (در قالب accounts/{account}/users/{email}) ایمیل کاربر اکنون بخشی از نام منبع است.
‫admin،‏ order_manager،‏ reporting_manager، و غیره. access_rights حقوق دسترسی اکنون در فیلد شمارشی تکراری ادغام شده است.
دردسترس نیست state فیلد جدید فقط خروجی که نشان می‌دهد کاربر PENDING است یا VERIFIED.

مدیریت کردن روابط و سرویس‌های حساب

در Content API ویژه Shopping، روابط با accounts.link مدیریت می‌شد. Merchant API مدل صریح‌تری را با منابع AccountService و AccountRelationship معرفی می‌کند که به فرایند دست‌دهی (پیشنهاد و پذیرش) نیاز دارد.

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

شرح درخواست Content API for Shopping میانای برنامه‌سازی کاربردی فروشنده
پیوند دادن حساب‌ها POST /content/v2.1/{merchantId}/accounts/{accountId}/link POST /accounts/v1/accounts/{account}/services:propose
فهرست کردن حساب‌های پیوندشده GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks ‫GET /accounts/v1/accounts/{account}/relationships و GET /accounts/v1/accounts/{account}/services

مقایسه دقیق فیلدها

میانای برنامه‌سازی کاربردی محتوا برای خرید (AccountLink) Merchant API (AccountService، AccountRelationship) یادداشت‌ها
linked_account_id provider (در AccountService) شناسه حسابی که سرویس را ارائه می‌دهد.
service service_type (در AccountService) نوع خدماتی که ارائه می‌شود (مثلاً ACCOUNT_AGGREGATION).
status handshake.approval_state (در AccountService) وضعیت پیوند (مثلاً PENDING، ESTABLISHED).

تنظیمات مالیات حساب

سرویس accounttax از Content API ویژه Shopping در Merchant API دردسترس نیست. دیگر نیازی به ارائه مالیات فروش ایالات متحده نیست، برای اطلاعات بیشتر به به‌روزرسانی مشخصات داده‌های محصول Merchant Center در سال ۲۰۲۵ مراجعه کنید.

مدیریت هویت کسب‌وکار

از منبع BusinessIdentity برای اعلام مشخصه‌های کسب‌وکارتان استفاده کنید. این مورد جایگزین شیء businessIdentity در Content API for Shopping می‌شود.

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

شرح درخواست Content API for Shopping میانای برنامه‌سازی کاربردی فروشنده
دریافت هویت کسب‌وکار GET /content/v2.1/{merchantId}/accounts/{accountId} (دسترسی به مشخصه business_identity) GET /accounts/v1/accounts/{account}/businessIdentity
به‌روزرسانی هویت کسب‌وکار PUT /content/v2.1/{merchantId}/accounts/{accountId} (درحال به‌روزرسانی مشخصه business_identity) PATCH /accounts/v1/accounts/{account}/businessIdentity

مقایسه دقیق فیلدها

میانای برنامه‌سازی کاربردی محتوا برای خرید (business_identity) Merchant API (BusinessIdentity) یادداشت‌ها
black_owned.self_identified (بولی) ‫black_owned.identity_declaration (enum) بولی با یک enum (SELF_IDENTIFIES_AS، DOES_NOT_SELF_IDENTIFY_AS) جایگزین شده است تا اظهارنامه صریح‌تر باشد. این موضوع برای همه مشخصه‌های هویتی صدق می‌کند.
include_for_promotions (بولی) ‫promotions_consent (enum) یک بولی سراسری با یک شمارشی توصیفی‌تر (PROMOTIONS_CONSENT_GIVEN، PROMOTIONS_CONSENT_DENIED) جایگزین شده است.

فهرست کردن حساب‌ها

در Content API for Shopping، تنها نوع حساب پیشرفته «حساب چندمشتری (MCA)» بود و روش accounts.list را برای فهرست کردن حساب‌های «حساب چندمشتری» داده‌شده نشان می‌داد. حساب‌های پیشرفته در Merchant API بسیار قدرتمندتر هستند و طیف گسترده‌تری از انواع حساب و روابط را امکان‌پذیر می‌کنند. برای اینکه حساب‌های پیشرفته بتوانند به‌راحتی انتقال را انجام دهند، Merchant API معادل مستقیمی برای accounts.list در Content API for Shopping به‌عنوان روش accounts.listSubaccounts ارائه می‌دهد. درحال معرفی روش جدید و قدرتمندتر accounts.list هستیم که امکان فیلتر کردن پیشرفته حساب را فراهم می‌کند.

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

شرح درخواست Content API for Shopping میانای برنامه‌سازی کاربردی فروشنده
فهرست کردن حساب‌های یک حساب پیشرفته GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
فهرست کردن همه حساب‌های دردسترس دردسترس نیست GET /accounts/v1/accounts

مقایسه دقیق فیلد (پارامترهای درخواست)

میانای برنامه‌سازی کاربردی محتوا برای خرید (accounts.list) Merchant API (accounts.listSubaccounts) یادداشت‌ها
merchant_id (پارامتر مسیر) provider (پارامتر مسیر) شناسه حساب پیشرفته در قالب accounts/{account}.
max_results page_size حداکثر تعداد حساب‌ها برای برگرداندن.
قبلی
Refactor code for concurrent requests
بعدی
Migrate accountstatuses to Account Issues