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.
getBusinessIdentity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
يسترجع هوية النشاط التجاري لحساب.
getBusinessInfo GET /accounts/v1beta/{name=accounts/*/businessInfo}
يسترد معلومات النشاط التجاري لحساب.
getHomepage GET /accounts/v1beta/{name=accounts/*/homepage}
يسترد الصفحة الرئيسية للمتجر.
getShippingSettings GET /accounts/v1beta/{name=accounts/*/shippingSettings}
استرداد معلومات إعدادات الشحن
list GET /accounts/v1beta/accounts
يسرد الحسابات التي يمكن للمستخدم الاتصال بها وتتطابق مع قيود الطلب، مثل حجم الصفحة أو الفلاتر.
listSubaccounts GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts
أدرِج كل الحسابات الفرعية لحساب متعدّد العملاء معيّن.
patch PATCH /accounts/v1beta/{account.name=accounts/*}
تعديل حساب بصرف النظر عن نوعه: حساب مستقل أو حساب متعدّد العملاء أو حساب فرعي
updateBusinessIdentity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
لتعديل هوية النشاط التجاري لأحد الحسابات.
updateBusinessInfo PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
يتم تعديل معلومات النشاط التجاري لأحد الحسابات.
updateHomepage PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage}
يعدِّل الصفحة الرئيسية للمتجر.

مورد REST: accounts_v1beta.accounts.accounttax

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

مورد REST: accounts_v1beta.accounts.homepage

الطُرق
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
تتم المطالبة بملكية الصفحة الرئيسية لمتجر.
unclaim POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim
لا تتم المطالبة بملكية الصفحة الرئيسية للمتجر.

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

الطُرق
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.
getEmailPreferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
تعرض إعدادات البريد الإلكتروني المفضَّلة لمستخدم حساب على Merchant Center.
list GET /accounts/v1beta/{parent=accounts/*}/users
يسرد جميع مستخدمي حساب على Merchant Center.
patch PATCH /accounts/v1beta/{user.name=accounts/*/users/*}
تعديلات على بيانات مستخدم حساب Merchant Center
updateEmailPreferences PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences}
يتم تعديل إعدادات البريد الإلكتروني المفضَّلة لمستخدم حساب على 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 محدّدَين.