يمكنك استخدام مورد الحسابات لإنشاء حساب التاجر وإدارته. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على واجهة برمجة تطبيقات حسابات التاجر.
توضّح هذه الصفحة كيفية نقل إدارة الحساب من 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 في Content API for Shopping. توفر واجهة برمجة التطبيقات لحسابات التاجر موارد متعددة لتمرير بيانات الحسابات. تتضمن هذه الموارد موارد Account وUser وBusinessInfo وBusinessIdentity.
يوفّر الجدول التالي مقارنة بين مورد Account في Content API for Shopping ومورِّد Account في واجهة برمجة تطبيقات حسابات Merchant Center.
| واجهة برمجة تطبيقات المحتوى في 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 في Merchant Center API.
| واجهة برمجة تطبيقات المحتوى في 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 في Merchant accounts API.
| واجهة برمجة تطبيقات المحتوى في Shopping | واجهة برمجة تطبيقات حسابات التجار |
|---|---|
businessInformation |
businessinfo |
phoneNumber |
phone |
phoneVerificationStatus |
phone_verification_state |
customerService |
customer_service |
koreanBusinessRegistrationNumber |
غير متوفّر |
يوفّر الجدول التالي مقارنة بين المورد AccountBusinessIdentity في Content API for Shopping والمرجع businessIdentity في Merchant accounts API.
| واجهة برمجة تطبيقات المحتوى في 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 for Shopping ومرجع identityAttribute في Merchant Account API.
| واجهة برمجة تطبيقات المحتوى في 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 |
يؤدي إلى طلب تعديل للمورد الذي تم فيه تحديد الحقل المطلوب أو مجموعة الحقول. |