نقل إدارة الحساب من Content API for Shopping

يوضّح هذا المستند كيفية نقل البيانات من الإصدار 2.1 من Content API إلى Merchant API.

نظرة عامة على التغييرات من الإصدار 2.1 من Content API إلى Merchant API

توفّر Merchant API تحسينات كبيرة مقارنةً بالإصدار 2.1 من Content API، بهدف تحسين سهولة الاستخدام والتناسق والمرونة للمطوّرين و الأنشطة التجارية.

بنية الموارد الدقيقة

تمثّل الموارد في Merchant API مفاهيم فردية، مثل account businessDetails وuser وhomepage وprogram. ويتم تنظيمها بشكل هرمي ليعكس علاقاتها. على سبيل المثال، account هو المورد الرئيسي لـ user.

خدمات الحساب المُوحّدة

تتم إدارة جميع خدمات الحسابات (على سبيل المثال، تجميع الحسابات المتعدّدة العملاء وحساباتها الفرعية أو بين مقدّمي الخدمات والحسابات التابعة لجهات خارجية) من خلال مورد موحّد accountService. يمكن لمقدّمي الخدمات إدارة علاقاتهم باستخدام مرجع accountRelationship.

بنية عنوان URL المبسّطة

تستخدم عناوين URL الآن معرّف حساب واحدًا (مثل merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}) بدلاً من معرّفات متعددة. تعكس مسارات عناوين URL بنية المورد الدقيقة.

تحسينات أخرى

  • إدارة محسّنة للبرامج والمستخدمين: يتم تجميع البرامج، مثل إعلانات Shopping و البيانات المجانية، ضمن مورد program واحد. يتضمّن user المورد إمكانات إدارة شاملة مع أذونات وصول دقیقة.
  • معلومات النشاط التجاري وهيكله: تتوفّر موارد مخصّصة لأجل businessInfo وbusinessIdentity. وتشمل هذه التقارير ميزات الامتثال للحقول الخاصة بالبيانات المتعلّقة بمنطقة معيّنة. على سبيل المثال، رقم تسجيل النشاط التجاري في كوريا
  • المطالبة بالصفحة الرئيسية بشكل سلس: يدير مورد مخصّص homepage عنوان URL للصفحة الرئيسية للمتجر. تعالج طُرق مثل claim و unclaim مطالبة الموقع الإلكتروني مباشرةً من خلال واجهة برمجة التطبيقات.
  • الامتثال لإرشادات Google API: تهدف Merchant API إلى التوافق مع اقتراحات تحسين واجهة برمجة التطبيقات من Google.

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

يمكنك استخدام مرجع accounts لمحاولة إنشاء حساب التاجر وإدارته. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على Merchant Accounts API.

توضّح هذه الصفحة كيفية نقل إدارة الحساب من Content API إلى Merchant API.

الطلبات

استخدِم تنسيق عنوان URL للطلب التالي لواجهة برمجة التطبيقات Merchant Accounts API:

https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts

في ما يلي نموذج مقارنة بين Content API for Shopping وMerchant Accounts API لطلبات إنشاء الحسابات وإدارتها:

  واجهة برمجة تطبيقات المحتوى في Shopping Merchant Accounts API
عنوان URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/ https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}
المعرفات merchantId,accountId ``name

الموارد

يتم تمرير بيانات الحساب باستخدام مرجع Account في Content API for Shopping. توفّر واجهة برمجة التطبيقات Merchant Accounts API موارد متعدّدة لنقل data الحسابات. وتشمل هذه المراجع Account وUser وBusinessInfo و BusinessIdentity.

يقدّم الجدول التالي مقارنة بين مرجع Account في Content API for Shopping ومرجع Account في Merchant Accounts API.

واجهة برمجة تطبيقات المحتوى في Shopping Merchant Accounts API
id name
name accountName
kind غير متوفر
websiteUrl حقل uri في المورد Homepage
adultContent adultContent
sellerId حقل accountIdAlias في المورد AccountRelationship
users في المرجع User
youtubeChannelLinks غير متاح بعد
googleMyBusinessLink غير متاح بعد
businessInformation في المرجع businessInfo
businessIdentity في المرجع businessIdentity
automaticImprovements غير متاح بعد
adsLinks حقل campaignsManagement في المورد AccountService
cssId متوفّرة في CSS API فقط
labelIds متوفّرة في واجهة برمجة التطبيقات CSS API فقط
accountManagement حقل accountManagement في المورد AccountService
automaticLabelIds متوفّرة في CSS API فقط
conversionSettings غير متاح بعد

يقدّم الجدول التالي مقارنة بين مرجع AccountUser في Content API for Shopping ومرجع User في Merchant Accounts API.

واجهة برمجة تطبيقات المحتوى في Shopping Merchant Accounts API
emailAddress البريد الإلكتروني هو جزء من name (accounts/{account}/users/{email}).
admin user#accessRights.ADMIN
orderManager غير متوفر
paymentsManager غير متاح
paymentsAnalyst غير متوفر
reportingManager user#accessRights.PERFORMANCE_REPORTING

يقدّم الجدول التالي مقارنة بين مرجع AccountBusinessInformation في Content API for Shopping والمرجع المكافئ له businessInfo في Merchant Accounts API.

واجهة برمجة تطبيقات المحتوى في Shopping Merchant Accounts API
address address
phoneNumber phone
phoneVerificationStatus phoneVerificationState
customerService customerService
koreanBusinessRegistrationNumber koreanBusinessRegistrationNumber

يقدّم الجدول التالي مقارنة بين مرجع AccountBusinessIdentity في Content API for Shopping ومرجع businessIdentity في Merchant Accounts API.

واجهة برمجة تطبيقات المحتوى في Shopping Merchant Accounts API
blackOwned blackOwned
womenOwned womenOwned
veteranOwned veteranOwned
latinoOwned latinoOwned
smallBusiness smallBusiness
includeForPromotions promotionsConsent
- true يشير إلى PROMOTION_CONSENT_GIVEN
- false يشير إلى PROMOTION_CONSENT_DENIED

يمثّل نوع IdentityAttribute وحقله identityDeclaration في MerchantAPI مرجع AccountIdentityType في Content API.

واجهة برمجة تطبيقات المحتوى في Shopping Merchant Accounts API
self_identified identityDeclaration
- true يشير إلى SELF_IDENTIFIES_AS
- false يشير إلى DOES_NOT_SELF_IDENTIFY_AS

الطُرق

تمّت إضافة الطرق التالية في Merchant Accounts API:

واجهة برمجة تطبيقات المحتوى في Shopping Merchant Accounts API
accounts.authinfo GET https://merchantapi.googleapis.com/accounts/v1beta/accounts بدون فلتر
accounts.claimwebsite POST https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/homepage:claim لمزيد من المعلومات، يُرجى الاطّلاع على الطريقة: accounts.v1beta.accounts.homepage.claim.
accounts.custombatch هذه الميزة غير متوفّرة. الحِزم المخصّصة غير متاحة في Merchant API.
accounts.delete DELETE https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}
accounts.get GET https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}`
accounts.insert POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء حساب تاجر وضبطه.
accounts.link مورد AccountService
accounts.list GET https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}:listSubaccounts
accounts.listlinks GET https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/services
accounts.requestphoneverification غير مدعوم.
accounts.update يتمّ ربطها بطلب تعديل للمورد الذي تمّ فيه تحديد الحقل المطلوب أو مجموعة الحقول.
accounts.updatelabels متوفّرة في CSS API فقط
accounts.verifyphonenumber غير مدعوم.
السابق
نظرة عامة
التالي
نقل بيانات إدارة المستودع