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

يمكنك استخدام صفحة accounts من الموارد إنشاء حساب التاجر وإدارته لمزيد من المعلومات، راجع نظرة عامة على واجهة برمجة التطبيقات لحسابات التجار:

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

الطلبات

استخدِم تنسيق عنوان URL التالي الخاص بالطلب في Merchant Center API:

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

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

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

الموارد

يتم تمرير بيانات الحساب باستخدام مرجع Account في "المحتوى" واجهة برمجة التطبيقات في Shopping. توفّر واجهة برمجة التطبيقات لحسابات التاجر موارد متعددة لاجتياز بيانات الحسابات. تتضمن هذه الموارد Account وUser وBusinessInfo و BusinessIdentity مورد.

يقدِّم الجدول التالي مقارنة بين Account في Content API for Shopping مرجع Account في واجهة برمجة التطبيقات لحسابات التاجر:

واجهة برمجة تطبيقات المحتوى في Shopping	واجهة برمجة تطبيقات حسابات التجار
id	account_id
name	account_name
kind	غير متوفر
websiteUrl	الحقل "uri" في المرجع "homepage"
adultContent	adult_content
sellerId	غير متوفر
users	في مورد واحد (User)
youtubeChannelLinks	غير متاح بعد
googleMyBusinessLink	غير متاح بعد
businessInformation	في مورد واحد (businessInfo)
businessIdentity	في مورد واحد (businessIdentity)
automaticImprovements	غير متاح بعد
adsLinks	غير متاح بعد
cssId	تتوفّر فقط في CSS API.
labelIds	تتوفّر فقط في CSS API.
accountManagement	غير متاح بعد
automaticLabelIds	تتوفّر فقط في CSS API.
conversionSettings	غير متاح بعد

يقدِّم الجدول التالي مقارنة بين مرجع AccountUser في Content API for Shopping وUser في واجهة برمجة تطبيقات حسابات التاجر.

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

يقدِّم الجدول التالي مقارنة بين AccountBusinessInformation المورد في Content API for Shopping والمرجع المكافئ له businessinfo في واجهة برمجة تطبيقات حسابات التاجر

واجهة برمجة تطبيقات المحتوى في Shopping	واجهة برمجة تطبيقات حسابات التجار
businessInformation	businessinfo
phoneNumber	phone
phoneVerificationStatus	phone_verification_state
customerService	customer_service
koreanBusinessRegistrationNumber	غير متوفر

يقدِّم الجدول التالي مقارنة بين مورد AccountBusinessIdentity في Content API للنطاق Shopping مرجع businessIdentity في واجهة برمجة تطبيقات حسابات التاجر

واجهة برمجة تطبيقات المحتوى في Shopping	واجهة برمجة تطبيقات حسابات التجار
blackOwned	black_owned
womenOwned	women_owned
veteranOwned	veteran_owned
latinoOwned	latino_owned
smallBusiness	small_business
includeForPromotions	promotions_consent true تشير إلى PROMOTION_CONSENT_GIVEN يشير false إلى PROMOTION_CONSENT_DENIED

يقدِّم الجدول التالي مقارنة بين مورد AccountIdentityType في Content API لـ Shopping ومرجع identityAttribute في واجهة برمجة تطبيقات حسابات التجار.

واجهة برمجة تطبيقات المحتوى في Shopping	واجهة برمجة تطبيقات حسابات التجار
self_identified	identity_declaration true تشير إلى SELF_IDENTIFIES_AS يشير false إلى DOES_NOT_SELF_IDENTIFY_AS

الطُرق

تم تقديم الطرق التالية في واجهة برمجة تطبيقات حسابات التجار:

واجهة برمجة تطبيقات المحتوى في Shopping	واجهة برمجة تطبيقات حسابات التجار
accounts.authinfo	GET https://merchantapi.googleapis.com/accounts/v1beta/accounts بدون فلتر
accounts.claimwebsite	POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId/homepage:claim لمزيد من المعلومات، يُرجى الاطّلاع على الطريقة: accounts.v1beta.accounts.homepage.claim
accounts.custombatch	هذه الميزة غير متوفّرة. لا تتوفّر الدفعة المخصّصة في Merchant API.
accounts.delete	DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId
accounts.get	يؤدي إلى طلب GET للمورد الذي تم تحديد الحقل المطلوب أو مجموعة الحقول فيه.
accounts.insert	POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure لمزيد من المعلومات، راجِع المقالة إنشاء حساب تاجر وإعداده.
accounts.link	لم تتوفر بعد
accounts.list	GET https://merchantapi.googleapis.com/accounts/v1beta/accountId:listSubaccounts
accounts.listlinks	لم تتوفر بعد
accounts.update	يؤدي إلى طلب تعديل للمورد الذي تم فيه تحديد الحقل المطلوب أو مجموعة الحقول.