Merchant API

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

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

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

مستند Discovery

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

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

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

  • https://merchantapi.googleapis.com

مورد 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: 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.accounttax

الطُرق
get GET /accounts/v1beta/{name=accounts/*/accounttax/*}
لعرض قواعد الضرائب التي تتطابق مع شروط GetAccountTaxRequest
patch PATCH /accounts/v1beta/{accountTax.name=accounts/*/accounttax/*}
لتعديل إعدادات الضريبة في الحساب

مورد 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 محدّدَين.