تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

نقل إدارة الحساب من 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:

POST 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/accounts/`accountId
المعرفات	merchantId`/accounts/`accountId	`accounts/`accountId

الموارد

يتم تمرير بيانات الحساب باستخدام مرجع 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](/merchant/api/reference/rest/v1/accounts.v1beta.accounts.users)`
`youtubeChannelLinks`	غير متاح بعد
`googleMyBusinessLink`	غير متاح بعد
`businessInformation`	في المرجع `[businessInfo](/merchant/api/reference/rest/v1/BusinessInfo)`
`businessIdentity`	في المرجع `[businessIdentity](/merchant/api/reference/rest/v1/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
`businessInformation`	`businessInfo`
`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 AccountIdentityType في Content API الحقل identityDeclaration في MerchantAPI.

واجهة برمجة تطبيقات المحتوى في 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/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 https://merchantapi.googleapis.com/accounts/v1beta/`accountId`
`accounts.insert`	`POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure`
	لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء حساب تاجر وضبط إعداداته.
`accounts.link`	مورد `AccountService`
`accounts.list`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`:listSubaccounts`
`accounts.listlinks`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`/services`
`accounts.update`	يتمّ ربطها بطلب تعديل للمورد الذي تمّ فيه تحديد الحقل المطلوب أو مجموعة الحقول.

نظرة عامة

نقل بيانات إدارة المستودع