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

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

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

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

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

تمثّل الموارد في Merchant API مفاهيم فردية، مثل

• account
  • businessInfo
  • user
  • homepage
  • program

account هو المورد الرئيسي للموارد الأخرى.

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

تتم إدارة جميع خدمات الحسابات (على سبيل المثال، تجميع الحسابات المتعدّدة العملاء وحساباتها الفرعية أو بين مقدّمي الخدمات والحسابات التابعة لجهات خارجية) من خلال مورد موحّد 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/accounts/{ACCOUNT_ID}

في ما يلي نموذج مقارنة بين 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} بالتنسيق: accounts/{ACCOUNT_ID}

الموارد

يتم تمرير بيانات الحساب باستخدام مرجع 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

يمثّل المرجع AccountIdentityType في Content API النوع IdentityAttribute حقله IdentityDeclaration في Merchant 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.get مع المَعلمة view.
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 إذا كنت من مستخدمي خدمة مقارنة الأسعار (CSS)، يمكنك استخدام طريقة ListChildAccounts لعرض جميع الحسابات المرتبطة بحساب CSS معيّن.
accounts.listlinks	GET https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/services
accounts.requestphoneverification	لا تتيح Merchant API طريقة إثبات الهوية عبر الهاتف.
accounts.update	مورد Accounts.patch
accounts.updatelabels	متوفّرة فقط في CSS API
accounts.verifyphonenumber	غير مدعوم.