مهاجرت مدیریت حساب

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

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

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

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

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

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

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

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

  • شرایط خدمات: با استفاده از منابع TermsOfService و TermsOfServiceAgreementState ، به طور برنامه‌نویسی شرایط خدمات را بازیابی و بپذیرید.
  • دسترسی به حساب توسط نام مستعار: با استفاده از فرمت providerId~accountAlias به حساب‌ها دسترسی پیدا کنید، که روشی ثابت برای کسب‌وکارهایی که چندین حساب را مدیریت می‌کنند تا از شناسه‌های حساب خود استفاده کنند، ارائه می‌کند.

درخواست ها

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

درخواست توضیحات Content API برای خرید Merchant API
دریافت حساب 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 برای خرید Merchant API
جزئیات حساب را دریافت کنید 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}

مقایسه میدانی دقیق

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

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

از منبع BusinessInfo برای مدیریت اطلاعات عمومی در مورد کسب و کار خود مانند آدرس و مخاطبین خدمات مشتری خود استفاده کنید. این جایگزین شی businessInformation در Content API for Shopping می شود.

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

درخواست توضیحات Content API برای خرید Merchant API
اطلاعات کسب و کار را دریافت کنید 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

مقایسه میدانی دقیق

Content API for Shopping ( business_information ) Merchant API ( BusinessInfo ) یادداشت ها
phone_number phone فیلد اکنون phone است و از google.type.PhoneNumber استفاده می کند.
customer_service.url customer_service.uri نام فیلد اکنون uri است.

صفحه اصلی خود را مدیریت کنید

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

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

درخواست توضیحات Content API برای خرید Merchant API
دریافت URL صفحه اصلی GET /content/v2.1/{merchantId}/accounts/{accountId} (دسترسی به ویژگی website_url ) GET /accounts/v1/accounts/{account}/homepage
URL صفحه اصلی را به روز کنید 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

مقایسه میدانی دقیق

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

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

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

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

درخواست توضیحات Content API برای خرید Merchant API
لیست کاربران 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}

مقایسه میدانی دقیق

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

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

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

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

درخواست توضیحات Content API برای خرید Merchant API
حساب ها را پیوند دهید 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

مقایسه میدانی دقیق

Content API برای خرید ( 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 برای خرید در Merchant API در دسترس نیست. دیگر نیازی به ارائه مالیات بر فروش ایالات متحده نیست، برای اطلاعات بیشتر به به روز رسانی مشخصات داده های محصول Merchant Center 2025 مراجعه کنید.

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

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

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

درخواست توضیحات Content API برای خرید Merchant API
هویت کسب و کار را بدست آورید 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

مقایسه میدانی دقیق

Content API for Shopping ( business_identity ) Merchant API ( BusinessIdentity ) یادداشت ها
black_owned.self_identified (بولی) black_owned.identity_declaration (enum) برای اعلان صریح تر، بولین با یک عدد ( SELF_IDENTIFIES_AS ، DOES_NOT_SELF_IDENTIFY_AS ) جایگزین می شود. این در مورد تمام ویژگی های هویت صدق می کند.
include_for_promotions (بولی) promotions_consent (تعدادی) یک بولی جهانی با یک عدد توصیفی تر جایگزین می شود ( PROMOTIONS_CONSENT_GIVEN ، PROMOTIONS_CONSENT_DENIED ).

فهرست حساب ها

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

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

درخواست توضیحات Content API برای خرید Merchant API
حساب های فرعی را فهرست کنید GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
همه حساب های قابل دسترسی را فهرست کنید در دسترس نیست GET /accounts/v1/accounts

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

Content API for Shopping ( accounts.list ) Merchant API ( accounts.listSubaccounts ) یادداشت ها
merchant_id (پارامتر مسیر) provider (پارامتر مسیر) شناسه حساب پیشرفته در قالب accounts/{account} .
max_results page_size حداکثر تعداد حساب هایی که باید بازگردانده شوند.