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

رابط برنامه‌نویسی کاربردی حساب‌ها (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 ) جایگزین می‌شود. این موضوع در مورد همه ویژگی‌های هویتی صدق می‌کند.
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 حداکثر تعداد حساب‌هایی که باید بازگردانده شوند.
،

رابط برنامه‌نویسی کاربردی حساب‌ها (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 حداکثر تعداد حساب‌هایی که باید بازگردانده شوند.
،

رابط برنامه‌نویسی کاربردی حساب‌ها (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 حداکثر تعداد حساب‌هایی که باید بازگردانده شوند.
،

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

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

Use the BusinessInfo resource to manage public information about your business, such as your address and customer service contacts. This replaces the businessInformation object in Content API for Shopping.

Request comparison

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (API) فروشنده
Get business information GET /content/v2.1/{merchantId}/accounts/{accountId} (accessing the business_information attribute) GET /accounts/v1/accounts/{account}/businessInfo
Update business information PUT /content/v2.1/{merchantId}/accounts/{accountId} (updating the business_information attribute) PATCH /accounts/v1/accounts/{account}/businessInfo

Detailed field comparison

Content API for Shopping ( business_information ) Merchant API ( BusinessInfo ) یادداشت‌ها
phone_number phone The field is now phone and uses google.type.PhoneNumber .
customer_service.url customer_service.uri The field name is now uri .

Manage your homepage

To manage your store's website URL and perform verification and claiming, use the Homepage resource. This replaces the websiteUrl field and the accounts.claimwebsite method from Content API for Shopping.

Request comparison

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (API) فروشنده
Get homepage URL GET /content/v2.1/{merchantId}/accounts/{accountId} (accessing the website_url attribute) GET /accounts/v1/accounts/{account}/homepage
Update homepage URL PUT /content/v2.1/{merchantId}/accounts/{accountId} (updating the website_url attribute) PATCH /accounts/v1/accounts/{account}/homepage
Claim homepage POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
Unclaim homepage موجود نیست POST /accounts/v1/accounts/{account}/homepage:unclaim

Detailed field comparison

Content API for Shopping ( Account ) Merchant API ( Homepage ) یادداشت‌ها
website_url uri The URL of the store's homepage.
Not directly available claimed A boolean field that is true if the homepage is claimed.

Manage users

The User resource lets you manage who can access a Merchant Center account. This replaces the users array within the Account resource. A key difference is the user creation process. In Merchant API, adding a user sends an invitation. The user must accept the invitation before they can access the account.

Request comparison

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (API) فروشنده
List users GET /content/v2.1/{merchantId}/accounts/{accountId} (accessing the users attribute) GET /accounts/v1/accounts/{account}/users
Create a user PUT /content/v2.1/{merchantId}/accounts/{accountId} (updating the users attribute) POST /accounts/v1/accounts/{account}/users
Update a user PUT /content/v2.1/{merchantId}/accounts/{accountId} (updating the users attribute) PATCH /accounts/v1/accounts/{account}/users/{email}
Delete a user PUT /content/v2.1/{merchantId}/accounts/{accountId} (updating the users attribute) DELETE /accounts/v1/accounts/{account}/users/{email}

Detailed field comparison

Content API for Shopping ( users array object) Merchant API ( User resource) یادداشت‌ها
email_address name (in format accounts/{account}/users/{email} ) The user's email is now part of the resource name.
admin , order_manager , reporting_manager , etc. access_rights Access rights are now consolidated into a repeated enum field.
موجود نیست state A new output-only field indicating if the user is PENDING or VERIFIED .

Manage account relationships and services

In Content API for Shopping, relationships were managed with accounts.link . Merchant API introduces a more explicit model with AccountService and AccountRelationship resources, requiring a handshake process (propose and accept).

Request comparison

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (API) فروشنده
حساب‌های کاربری را لینک کنید POST /content/v2.1/{merchantId}/accounts/{accountId}/link POST /accounts/v1/accounts/{account}/services:propose
List linked accounts GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks GET /accounts/v1/accounts/{account}/relationships and GET /accounts/v1/accounts/{account}/services

Detailed field comparison

Content API for Shopping ( AccountLink ) Merchant API ( AccountService , AccountRelationship ) یادداشت‌ها
linked_account_id provider (in AccountService ) The ID of the account providing the service.
service service_type (in AccountService ) The type of service being provided (eg, ACCOUNT_AGGREGATION ).
status handshake.approval_state (in AccountService ) The status of the link (eg, PENDING , ESTABLISHED ).

Account tax settings

The accounttax service from the Content API for Shopping is not available in Merchant API. It is no longer required to provide US sales tax, for more information see Merchant Center product data specification update 2025 .

Manage business identity

Use the BusinessIdentity resource to self-declare attributes about your business. This replaces the businessIdentity object in Content API for Shopping.

Request comparison

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (API) فروشنده
Get business identity GET /content/v2.1/{merchantId}/accounts/{accountId} (accessing the business_identity attribute) GET /accounts/v1/accounts/{account}/businessIdentity
Update business identity PUT /content/v2.1/{merchantId}/accounts/{accountId} (updating the business_identity attribute) PATCH /accounts/v1/accounts/{account}/businessIdentity

Detailed field comparison

Content API for Shopping ( business_identity ) Merchant API ( BusinessIdentity ) یادداشت‌ها
black_owned.self_identified (boolean) black_owned.identity_declaration (enum) The boolean is replaced by an enum ( SELF_IDENTIFIES_AS , DOES_NOT_SELF_IDENTIFY_AS ) for more explicit declaration. This applies to all identity attributes.
include_for_promotions (boolean) promotions_consent (enum) A global boolean is replaced by a more descriptive enum ( PROMOTIONS_CONSENT_GIVEN , PROMOTIONS_CONSENT_DENIED ).

List accounts

In Content API for Shopping the only type of advanced account was a 'Multi-Client Account (MCA)' and it exposed an accounts.list method to list the accounts of the given Multi-Client Account. Advanced accounts in Merchant API are much more powerful, allowing a broader range of account types and relationships. To allow a straightforward migration for advanced accounts, Merchant API provides a direct equivalent to Content API for Shopping's accounts.list as a accounts.listSubaccounts method. We are introducing a new, more powerful accounts.list method that allows advanced account filtering.

Request comparison

درخواست توضیحات API محتوا برای خرید رابط برنامه‌نویسی کاربردی (API) فروشنده
List accounts of an advanced account GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
List all accessible accounts موجود نیست GET /accounts/v1/accounts

Detailed field comparison (Request parameters)

Content API for Shopping ( accounts.list ) Merchant API ( accounts.listSubaccounts ) یادداشت‌ها
merchant_id (path parameter) provider (path parameter) The ID of the advanced account in the format accounts/{account} .
max_results page_size The maximum number of accounts to return.
قبلی
Refactor code for concurrent requests
بعدی
Migrate accountstatuses to Account Issues