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

رابط برنامه‌نویسی کاربردی حساب‌ها (Application Programming Interface) به مجموعه‌ای از منابع تقسیم شده است تا امکان مدیریت کارآمدتر حساب‌های مرکز فروشندگان (Merchant Center) و کنترل دقیق‌تر بر جنبه‌های مختلف حساب شما را فراهم کند.

این راهنما تغییرات کلیدی را توضیح می‌دهد و به شما کمک می‌کند تا یکپارچه‌سازی مدیریت حساب کاربری فعلی خود را از API محتوا برای خرید به API فروشنده منتقل کنید.

از یک منبع تا منابع بسیار

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

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

در اینجا خلاصه‌ای از چگونگی تطبیق مفاهیم از API محتوا برای منبع Account خرید با منابع جدید در API فروشنده ارائه شده است:

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

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

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

درخواست‌ها

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

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (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) شامل جزئیات ضروری یک حساب مرکز فروشنده، مانند نام، شناسه و تنظیمات اولیه آن است.

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

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (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}

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

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

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

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

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

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (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

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

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

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

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

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

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (API) فروشنده
دریافت آدرس صفحه اصلی 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

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

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

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

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

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

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (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}

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

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

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

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

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

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (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

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

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

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

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

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

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

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

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (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

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

API محتوا برای خرید ( business_identity ) رابط برنامه‌نویسی کاربردی فروشنده ( BusinessIdentity ) یادداشت‌ها
black_owned.self_identified (بولی) black_owned.identity_declaration (شمارشی) برای تعریف صریح‌تر، مقدار بولی با یک enum ( SELF_IDENTIFIES_AS ، DOES_NOT_SELF_IDENTIFY_AS ) جایگزین می‌شود. این موضوع در مورد همه ویژگی‌های identity صدق می‌کند.
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 هستیم که امکان فیلتر کردن پیشرفته حساب‌ها را فراهم می‌کند.

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

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (API) فروشنده
لیست حساب‌های یک حساب پیشرفته GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
فهرست کردن تمام حساب‌های کاربری قابل دسترسی موجود نیست GET /accounts/v1/accounts

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

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