نقل إدارة الحساب من 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
• businessInfo
• 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/{ACCOUNT_ID}/accounts

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

	Content API	Merchant API
عنوان URL	https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accounts/{ACCOUNT_ID}	https://merchantapi.googleapis.com/accounts/v1beta/{NAME}
المعرفات	"{MERCHANT_ID}" و"{ACCOUNT_ID}"	{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 مرجع 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	غير مدعوم.