Merchant API

إدارة حساباتك على Merchant Center آليًا

الخدمة: merchantapi.googleapis.com

للاتّصال بهذه الخدمة، ننصحك باستخدام مكتبات العملاء التي تقدّمها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة للاتصال بهذه الخدمة، استخدِم المعلومات التالية عند إجراء طلبات واجهة برمجة التطبيقات.

المستند المرتبط بميزة "اقتراحات"

مستند الاكتشاف هو مواصفة قابلة للقراءة آليًا لوصف واجهات برمجة التطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات العملاء ومكونات إضافية لبيئة تطوير البرامج المتكاملة وأدوات أخرى تتفاعل مع واجهات برمجة تطبيقات Google. قد توفّر خدمة واحدة عدّة مستندات اكتشاف. توفّر هذه الخدمة مستندات الاكتشاف التالية:

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدِّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تتضمّن خدمة واحدة عدة نقاط نهاية للخدمات. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية، وترتبط كل معرّفات الموارد المنتظمة (URI) أدناه بنقطة نهاية الخدمة هذه:

  • https://merchantapi.googleapis.com

مورد REST: ‏ reviews_v1beta.accounts.merchantReviews

الطُرق
delete DELETE /reviews/v1beta/{name=accounts/*/merchantReviews/*}
يؤدي هذا الإجراء إلى حذف مراجعة التاجر.
get GET /reviews/v1beta/{name=accounts/*/merchantReviews/*}
يحصل على مراجعة من التاجر.
insert POST /reviews/v1beta/{parent=accounts/*}/merchantReviews:insert
تُدرج هذه القيمة مراجعة لحسابك على Merchant Center.
list GET /reviews/v1beta/{parent=accounts/*}/merchantReviews
تعرض مراجعات التجار.

مورد REST: ‏ reviews_v1beta.accounts.productReviews

الطُرق
delete DELETE /reviews/v1beta/{name=accounts/*/productReviews/*}
لحذف مراجعة منتج.
get GET /reviews/v1beta/{name=accounts/*/productReviews/*}
يحصل على مراجعة للمنتج.
insert POST /reviews/v1beta/{parent=accounts/*}/productReviews:insert
تُستخدَم هذه العلامة لإدراج مراجعة منتج.
list GET /reviews/v1beta/{parent=accounts/*}/productReviews
تعرض هذه السمة مراجعات المنتجات.

مورد REST: ‏ reports_v1beta.accounts.reports

الطُرق
search POST /reports/v1beta/{parent=accounts/*}/reports:search
يسترجع تقريرًا محدّدًا من خلال طلب بحث.

مورد REST: ‏ quota_v1beta.accounts.quotas

الطُرق
list GET /quota/v1beta/{parent=accounts/*}/quotas
تعرض هذه السمة الحصة اليومية للمكالمات ومعدل الاستخدام لكل مجموعة في حسابك على Merchant Center.

مورد REST: ‏ promotions_v1beta.accounts.promotions

الطُرق
get GET /promotions/v1beta/{name=accounts/*/promotions/*}
يسترجع هذا الإجراء العرض الترويجي من حسابك على Merchant Center.
insert POST /promotions/v1beta/{parent=accounts/*}/promotions:insert
تُدرج هذه القيمة عرضًا ترويجيًا لحسابك على Merchant Center.
list GET /promotions/v1beta/{parent=accounts/*}/promotions
تعرض هذه الصفحة العروض الترويجية في حسابك على Merchant Center.

مورد REST: ‏ products_v1beta.accounts.productInputs

الطُرق
delete DELETE /products/v1beta/{name=accounts/*/productInputs/*}
يؤدي هذا الزر إلى حذف إدخال منتج من حسابك على Merchant Center.
insert POST /products/v1beta/{parent=accounts/*}/productInputs:insert
لتحميل إدخال منتج إلى حسابك على Merchant Center.

مورد REST: ‏ products_v1beta.accounts.products

الطُرق
get GET /products/v1beta/{name=accounts/*/products/*}
يسترجع هذا الطلب المنتج الذي تمت معالجته من حسابك على Merchant Center.
list GET /products/v1beta/{parent=accounts/*}/products
تعرض هذه الصفحة المنتجات التي تمت معالجتها في حسابك على Merchant Center.

مورد REST: ‏ notifications_v1beta.accounts.notificationsubscriptions

الطُرق
create POST /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
لإنشاء اشتراك في إشعارات لنشاط تجاري
delete DELETE /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
لحذف اشتراك تاجر في الإشعارات
get GET /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
للحصول على اشتراكات الإشعارات لحساب معيّن
list GET /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
للحصول على جميع اشتراكات الإشعارات للتاجر.
patch PATCH /notifications/v1beta/{notificationSubscription.name=accounts/*/notificationsubscriptions/*}
لتعديل اشتراك حالي في الإشعارات للتاجر

مورد REST: ‏ lfp_v1beta.accounts.lfpInventories

الطُرق
insert POST /lfp/v1beta/{parent=accounts/*}/lfpInventories:insert
تُستخدَم هذه السمة لإدراج مرجع LfpInventory لحساب التاجر المستهدَف المحدّد.

مورد REST: ‏ lfp_v1beta.accounts.lfpSales

الطُرق
insert POST /lfp/v1beta/{parent=accounts/*}/lfpSales:insert
تُستخدَم هذه السمة لإدراج LfpSale للتاجر المحدّد.

مورد REST: ‏ lfp_v1beta.accounts.lfpStores

الطُرق
delete DELETE /lfp/v1beta/{name=accounts/*/lfpStores/*}
لحذف متجر لتاجر مستهدَف.
get GET /lfp/v1beta/{name=accounts/*/lfpStores/*}
لاسترداد معلومات عن متجر.
insert POST /lfp/v1beta/{parent=accounts/*}/lfpStores:insert
تُستخدَم هذه السمة لإدراج متجر للتاجر المستهدَف.
list GET /lfp/v1beta/{parent=accounts/*}/lfpStores
تعرض هذه السمة متاجر التاجر المستهدَف المحدّدة من خلال الفلتر في ListLfpStoresRequest.

مورد REST: ‏ inventories_v1beta.accounts.products.localInventories

الطُرق
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/localInventories/*}
يؤدي ذلك إلى حذف LocalInventory المحدّد من المنتج المحدّد في حساب التاجر.
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/localInventories:insert
تُستخدَم هذه السمة لإدراج مرجع LocalInventory في منتج في حساب التاجر.
list GET /inventories/v1beta/{parent=accounts/*/products/*}/localInventories
يسرد هذا الحقل LocalInventory مراجع المنتج المحدّد في حساب التاجر.

مورد REST: ‏ inventories_v1beta.accounts.products.regionalInventories

الطُرق
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/regionalInventories/*}
يؤدي هذا الإجراء إلى حذف مورد RegionalInventory المحدّد من المنتج المحدّد في حساب التاجر.
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories:insert
تُستخدَم هذه الوسيطة لإدراج رمز RegionalInventory في منتج معيّن في حساب التاجر.
list GET /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories
يسرد هذا الحقل RegionalInventory مراجع المنتج المحدّد في حساب التاجر.

مورد REST: ‏ datasources_v1beta.accounts.dataSources

الطُرق
create POST /datasources/v1beta/{parent=accounts/*}/dataSources
لإنشاء إعدادات مصدر البيانات الجديد للحساب المحدّد.
delete DELETE /datasources/v1beta/{name=accounts/*/dataSources/*}
يؤدي هذا الإجراء إلى حذف مصدر بيانات من حسابك على Merchant Center.
fetch POST /datasources/v1beta/{name=accounts/*/dataSources/*}:fetch
تُجري هذه العملية جلب البيانات على الفور (حتى خارج الجدول الزمني لجلب البيانات) من مصدر بيانات في حسابك على Merchant Center.
get GET /datasources/v1beta/{name=accounts/*/dataSources/*}
يسترجع إعدادات مصدر البيانات للحساب المحدّد.
list GET /datasources/v1beta/{parent=accounts/*}/dataSources
تعرض هذه السمة إعدادات مصادر البيانات للحساب المحدّد.
patch PATCH /datasources/v1beta/{dataSource.name=accounts/*/dataSources/*}
يؤدي هذا الإجراء إلى تعديل إعدادات مصدر البيانات الحالي.

مورد REST: ‏ datasources_v1beta.accounts.dataSources.fileUploads

الطُرق
get GET /datasources/v1beta/{name=accounts/*/dataSources/*/fileUploads/*}
تحصل على آخر عملية تحميل لملف مصدر البيانات.

مورد REST: ‏ conversions_v1beta.accounts.conversionSources

الطُرق
create POST /conversions/v1beta/{parent=accounts/*}/conversionSources
لإنشاء مصدر إحالة ناجحة جديد.
delete DELETE /conversions/v1beta/{name=accounts/*/conversionSources/*}
لأرشفة مصدر إحالة ناجحة حالي.
get GET /conversions/v1beta/{name=accounts/*/conversionSources/*}
تُستخدَم هذه الدالة لجلب مصدر إحالة ناجحة.
list GET /conversions/v1beta/{parent=accounts/*}/conversionSources
يسترجع هذه الوظيفة قائمة مصادر الإحالات الناجحة التي يمكن للمتصل الوصول إليها.
patch PATCH /conversions/v1beta/{conversionSource.name=accounts/*/conversionSources/*}
لتعديل معلومات مصدر إحالة ناجحة حالي.
undelete POST /conversions/v1beta/{name=accounts/*/conversionSources/*}:undelete
إعادة تفعيل مصدر إحالة ناجحة تم أرشفته

مورد REST: ‏ accounts_v1beta.accounts

الطُرق
createAndConfigure POST /accounts/v1beta/accounts:createAndConfigure
يؤدي هذا الإجراء إلى إنشاء حساب مستقل على Merchant Center مع إعدادات إضافية.
delete DELETE /accounts/v1beta/{name=accounts/*}
يؤدي هذا الإجراء إلى حذف الحساب المحدّد بغض النظر عن نوعه: حساب مستقل أو حساب متعدّد العملاء أو حساب فرعي.
get GET /accounts/v1beta/{name=accounts/*}
يسترجع هذا الإجراء حسابًا من حسابك على Merchant Center.
list GET /accounts/v1beta/accounts
تعرض هذه السمة الحسابات التي يمكن للمستخدم المُتصل الوصول إليها والتي تتطابق مع قيود الطلب، مثل حجم الصفحة أو الفلاتر.
listSubaccounts GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts
عرض جميع الحسابات الفرعية لحساب متعدّد العملاء معيّن
patch PATCH /accounts/v1beta/{account.name=accounts/*}
لتعديل حساب بغض النظر عن نوعه: حساب مستقل أو حساب متعدّد العملاء أو حساب فرعي

مورد REST: ‏ accounts_v1beta.accounts.autofeedSettings

الطُرق
getAutofeedSettings GET /accounts/v1beta/{name=accounts/*/autofeedSettings}
يسترجع إعدادات الخلاصة التلقائية لحساب معيّن.
updateAutofeedSettings PATCH /accounts/v1beta/{autofeedSettings.name=accounts/*/autofeedSettings}
لتعديل إعدادات الخلاصة التلقائية لحساب معيّن.

مورد REST: ‏ accounts_v1beta.accounts.businessIdentity

الطُرق
getBusinessIdentity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
يسترجع هوية النشاط التجاري لحساب معيّن.
updateBusinessIdentity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
لتعديل هوية النشاط التجاري لحساب معيّن.

مورد REST: ‏ accounts_v1beta.accounts.businessInfo

الطُرق
getBusinessInfo GET /accounts/v1beta/{name=accounts/*/businessInfo}
يسترجع معلومات النشاط التجاري لحساب معيّن.
updateBusinessInfo PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
لتعديل معلومات النشاط التجاري لحساب معيّن.

مورد REST: ‏ accounts_v1beta.accounts.emailPreferences

الطُرق
getEmailPreferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
تعرِض هذه السمة الإعدادات المفضّلة للبريد الإلكتروني لمستخدم حساب على Merchant Center.
updateEmailPreferences PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences}
تعديل الإعدادات المفضّلة للبريد الإلكتروني لمستخدم حساب على Merchant Center

مورد REST: ‏ accounts_v1beta.accounts.homepage

الطُرق
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
يُستخدَم للمطالبة بالصفحة الرئيسية لمتجر.
getHomepage ‫GET /accounts/v1beta/{name=accounts/*/homepage}
يسترجع الصفحة الرئيسية لمتجر.
unclaim POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim
إلغاء المطالبة بالصفحة الرئيسية لمتجر
updateHomepage PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage}
لتعديل الصفحة الرئيسية لمتجر.

مورد REST: ‏ accounts_v1beta.accounts.issues

الطُرق
list GET /accounts/v1beta/{parent=accounts/*}/issues
تعرض هذه الصفحة جميع مشاكل الحساب في حساب Merchant Center.

مورد REST: ‏ accounts_v1beta.accounts.onlineReturnPolicies

الطُرق
get GET /accounts/v1beta/{name=accounts/*/onlineReturnPolicies/*}
للحصول على سياسة إرجاع حالية لتاجر معيّن.
list GET /accounts/v1beta/{parent=accounts/*}/onlineReturnPolicies
تعرض هذه السمة جميع سياسات الإرجاع الحالية لتاجر معيّن.

مورد REST: ‏ accounts_v1beta.accounts.programs

الطُرق
disable POST /accounts/v1beta/{name=accounts/*/programs/*}:disable
أوقِف المشاركة في البرنامج المحدّد للحساب.
enable POST /accounts/v1beta/{name=accounts/*/programs/*}:enable
فعِّل المشاركة في البرنامج المحدّد للحساب.
get GET /accounts/v1beta/{name=accounts/*/programs/*}
تستردّ هذه الدالة البرنامج المحدّد للحساب.
list GET /accounts/v1beta/{parent=accounts/*}/programs
لاسترداد جميع البرامج للحساب.

مورد REST: ‏ accounts_v1beta.accounts.regions

الطُرق
create POST /accounts/v1beta/{parent=accounts/*}/regions
يؤدي هذا الإجراء إلى إنشاء تعريف منطقة في حسابك على Merchant Center.
delete DELETE /accounts/v1beta/{name=accounts/*/regions/*}
يؤدي هذا الإجراء إلى حذف تعريف منطقة من حسابك على Merchant Center.
get GET /accounts/v1beta/{name=accounts/*/regions/*}
يسترجع منطقة محدّدة في حسابك على Merchant Center.
list GET /accounts/v1beta/{parent=accounts/*}/regions
تعرض هذه السمة المناطق في حسابك على Merchant Center.
patch PATCH /accounts/v1beta/{region.name=accounts/*/regions/*}
لتعديل تعريف منطقة في حسابك على Merchant Center

مورد REST: ‏ accounts_v1beta.accounts.shippingSettings

الطُرق
getShippingSettings GET /accounts/v1beta/{name=accounts/*/shippingSettings}
استرداد معلومات إعدادات الشحن
insert POST /accounts/v1beta/{parent=accounts/*}/shippingSettings:insert
استبدِل إعدادات الشحن للتاجر بإعدادات الشحن عند الطلب.

مورد REST: ‏ accounts_v1beta.accounts.termsOfServiceAgreementStates

الطُرق
get GET /accounts/v1beta/{name=accounts/*/termsOfServiceAgreementStates/*}
تعرِض هذه السمة حالة اتفاقية بنود الخدمة.
retrieveForApplication GET /accounts/v1beta/{parent=accounts/*}/termsOfServiceAgreementStates:retrieveForApplication
يسترجع حالة الاتفاقية لبنود خدمة التطبيق.

مورد REST: ‏ accounts_v1beta.accounts.users

الطُرق
create POST /accounts/v1beta/{parent=accounts/*}/users
لإنشاء مستخدم لحساب على Merchant Center
delete DELETE /accounts/v1beta/{name=accounts/*/users/*}
يؤدي هذا الإجراء إلى حذف مستخدم حساب على Merchant Center.
get GET /accounts/v1beta/{name=accounts/*/users/*}
يسترجع مستخدمًا لحساب على Merchant Center.
list GET /accounts/v1beta/{parent=accounts/*}/users
تعرض هذه السمة جميع مستخدمي حساب على Merchant Center.
patch PATCH /accounts/v1beta/{user.name=accounts/*/users/*}
تعديل بيانات مستخدم حساب Merchant Center

مورد REST: ‏ accounts_v1beta.termsOfService

الطُرق
accept GET /accounts/v1beta/{name=termsOfService/*}:accept
يقبل TermsOfService.
get GET /accounts/v1beta/{name=termsOfService/*}
يسترجع TermsOfService المرتبط بالإصدار المقدَّم.
retrieveLatest GET /accounts/v1beta/termsOfService:retrieveLatest
يسترجع أحدث إصدار من TermsOfService لقيمة معيّنة من kind وregion_code.