نقل إدارة الحساب

تنقسم Accounts API إلى مجموعة من الموارد للسماح بإدارة حساباتك على Merchant Center بشكل أكثر فعالية مع تحكّم أكثر دقة في الجوانب المختلفة لحسابك.

يشرح هذا الدليل التغييرات الرئيسية ويساعدك في نقل عملية دمج إدارة حسابك الحالية من Content API for Shopping إلى Merchant API.

من مصدر واحد إلى مصادر متعددة

في Content API for Shopping، كان المرجع Account عبارة عن عنصر موحّد يحتوي على كل شيء، بدءًا من اسم الحساب وعنوان URL للموقع الإلكتروني وصولاً إلى قوائم المستخدمين ومعلومات النشاط التجاري.

تقسّم Merchant API هذه البيانات إلى عدة موارد أصغر حجمًا وأكثر تركيزًا. يتيح هذا التغيير إجراء طلبات بيانات أكثر استهدافًا وفعالية من واجهة برمجة التطبيقات. على سبيل المثال، لتعديل عنوان مؤسستك فقط، يمكنك الآن إرسال طلب PATCH إلى المورد BusinessInfo بدلاً من تعديل عنصر Account بالكامل.

في ما يلي ملخّص لكيفية ربط المفاهيم من مرجع Content API for Shopping Account بالموارد الجديدة في Merchant API:

إمكانات جديدة

توفّر Merchant API أيضًا إمكانات جديدة لإدارة الحسابات لم تكن متاحة في Content API for Shopping:

  • بنود الخدمة: يمكنك استرداد بنود الخدمة وقبولها آليًا باستخدام الموردَين TermsOfService وTermsOfServiceAgreementState.
  • إنشاء الحساب: تتيح طريقة accounts.createAndConfigure الآن إنشاء حسابات ذات علاقات (مثل accountManagement)، وضبط alias، وإيقاف تأكيد عنوان البريد الإلكتروني باستخدام الحقل user.verificationMailSettings.verificationMailMode لصالح التأكيد المستند إلى واجهة برمجة التطبيقات باستخدام طريقة accounts.verifySelf الجديدة.
  • الوصول إلى الحسابات باستخدام الاسم المستعار: يمكنك الوصول إلى الحسابات باستخدام تنسيق providerId~accountAlias، ما يوفّر طريقة متّسقة للشركات التي تدير حسابات متعدّدة لاستخدام معرّفات حساباتها الخاصة.

الطلبات

يقدّم هذا الجدول مقارنة مجمّعة لعناوين URL الخاصة بالطلبات لمهام إدارة الحسابات الشائعة بين Content API for Shopping وMerchant API.

وصف الطلب واجهة برمجة تطبيقات المحتوى في Shopping 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، مثل اسمه ورقم تعريفه وإعداداته الأساسية.

طلب مقارنة

وصف الطلب واجهة برمجة تطبيقات المحتوى في Shopping 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 for Shopping ‏ (Account) ‫Merchant API‏ (Account) ملاحظات
id account_id أصبح المعرّف الرقمي الآن حقلاً مخصّصًا للإخراج فقط. المعرّف الأساسي هو المورد name.
name account_name اسم الحساب الذي يمكن لشخص عادي قراءته
language language_code أصبح اسم الحقل الآن language_code.

إدارة معلومات المؤسسة

استخدِم المورد BusinessInfo لإدارة المعلومات المتاحة للجميع حول نشاطك التجاري، مثل عنوانك ومعلومات الاتصال بخدمة العملاء. يحلّ هذا محلّ العنصر businessInformation في Content API for Shopping.

طلب مقارنة

وصف الطلب واجهة برمجة تطبيقات المحتوى في Shopping 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.

طلب مقارنة

وصف الطلب واجهة برمجة تطبيقات المحتوى في Shopping 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 for Shopping ‏ (Account) ‫Merchant API‏ (Homepage) ملاحظات
website_url uri عنوان URL للصفحة الرئيسية الخاصة بالمتجر
غير متاح مباشرةً claimed حقل منطقي يكون true في حال المطالبة بالصفحة الرئيسية

إدارة المستخدمين

يتيح لك المورد User إدارة المستخدمين الذين يمكنهم الوصول إلى حساب على Merchant Center. يحلّ هذا محلّ مصفوفة users ضمن مورد Account. يتمثل الاختلاف الرئيسي في عملية إنشاء المستخدم. في Merchant API، تؤدي إضافة مستخدم إلى إرسال دعوة. يجب أن يقبل المستخدم الدعوة قبل أن يتمكّن من الوصول إلى الحساب.

طلب مقارنة

وصف الطلب واجهة برمجة تطبيقات المحتوى في Shopping 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 تم الآن دمج حقوق الوصول في حقل تعداد متكرر.
غير متوفر state حقل جديد للإخراج فقط يشير إلى ما إذا كان المستخدم PENDING أو VERIFIED.

إدارة علاقات الحسابات والخدمات

في Content API for Shopping، كانت العلاقات تُدار باستخدام accounts.link. توفّر Merchant API نموذجًا أكثر وضوحًا مع موارد AccountService و AccountRelationship ، ما يتطلّب عملية تأكيد (اقتراح وقبول).

طلب مقارنة

وصف الطلب واجهة برمجة تطبيقات المحتوى في Shopping 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 for Shopping ‏ (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 for Shopping في Merchant API. لم يعُد مطلوبًا تقديم ضريبة المبيعات في الولايات المتحدة. لمزيد من المعلومات، يُرجى الاطّلاع على التعديلات المتعلقة بمواصفات بيانات المنتجات للعام 2025 في Merchant Center.

إدارة هوية المؤسسة

استخدِم المرجع BusinessIdentity للإفصاح ذاتيًا عن سمات مؤسستك. يحلّ هذا محلّ العنصر businessIdentity في Content API for Shopping.

طلب مقارنة

وصف الطلب واجهة برمجة تطبيقات المحتوى في Shopping 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 (تعداد) تم استبدال القيمة المنطقية بتعداد (SELF_IDENTIFIES_AS، DOES_NOT_SELF_IDENTIFY_AS) لتقديم بيان أكثر وضوحًا. وينطبق ذلك على جميع سمات الهوية.
‫include_for_promotions (قيمة منطقية) promotions_consent (تعداد) تم استبدال قيمة منطقية عامة بتعداد أكثر وصفًا (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 تتيح فلترة حساب بامتيازات متقدّمة.

طلب مقارنة

وصف الطلب واجهة برمجة تطبيقات المحتوى في Shopping 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 الحد الأقصى لعدد الحسابات التي سيتم عرضها.
السابق
Refactor code for concurrent requests
التالي
Migrate accountstatuses to Account Issues