Package google.shopping.merchant.accounts.v1beta

الفهرس

AccountIssueService

خدمة متوافقة مع واجهة برمجة التطبيقات AccountIssueService

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

يعرض هذا القسم جميع المشاكل في حساب Merchant Center.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

AccountsService

خدمة لدعم واجهة برمجة التطبيقات Accounts API

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

يتم إنشاء حساب مستقل على Merchant Center مع إعدادات إضافية. تضيف هذه السمة المستخدم الذي يقدّم الطلب كمشرف للحساب الجديد.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

لحذف الحساب المحدّد بغض النظر عن نوعه: حساب مستقل أو حساب متعدّد العملاء أو حساب فرعي يؤدي حذف حساب MCA إلى حذف جميع حساباته الفرعية. يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف. لا يتم حذف الحساب إلا إذا لم يكن يقدّم خدمات لأي حساب آخر ولم يكن يتضمّن عروضًا تمّت معالجتها. يمكنك استخدام المَعلمة force لإلغاء ذلك.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

استرداد حساب من حسابك على Merchant Center بعد إدخال حساب أو تعديله أو حذفه، قد يستغرق تطبيق التغييرات عدة دقائق.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

يسرد الحسابات التي يمكن للمستخدم المتصل الوصول إليها والتي تتطابق مع قيود الطلب، مثل حجم الصفحة أو الفلاتر. لا يقتصر ذلك على إدراج الحسابات الفرعية لحساب MCA، بل يشمل جميع الحسابات التي يمكن للمستخدم المتصل الوصول إليها، بما في ذلك الحسابات المتعدّدة العملاء الأخرى والحسابات المرتبطة والحسابات المستقلة وما إلى ذلك. في حال عدم تقديم فلتر، يتم عرض الحسابات التي تمت إضافة المستخدم إليها مباشرةً. تكون هذه الطريقة متّسقة في النهاية، ما يعني أنّ التغييرات، مثل إنشاء حساب أو تعديله أو تغيير العلاقات بين الحسابات، قد لا تظهر في النتائج على الفور. بدلاً من ذلك، يتم نشر هذه التغييرات على مدار فترة قصيرة، وبعد ذلك يمكن أن تتطابق المعلومات المعدّلة مع العناصر المرتبطة. وهذا يعني أنّ البحث عن حساب بالاسم قد لا يعرض حسابًا تم تغييره مؤخرًا حتى لو كان يستوفي العبارة الشرطية.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

إدراج جميع الحسابات الفرعية لحساب متعدّد العملاء معيّن هذه حزمة مساعدة لاستخدام طريقة ListAccounts الأكثر فعالية. ستؤدي هذه الطريقة إلى تحقيق النتائج نفسها التي تحقّقها طريقة الاتصال بـ ListsAccounts باستخدام الفلتر التالي: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

تعديل حساب بغض النظر عن نوعه: حساب مستقل أو حساب متعدّد العملاء أو حساب فرعي يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

AutofeedSettingsService

الخدمة التي تتيح ضبط الخلاصة التلقائية

GetAutofeedSettings

rpc GetAutofeedSettings(GetAutofeedSettingsRequest) returns (AutofeedSettings)

استرداد إعدادات الخلاصة التلقائية لحساب معيّن

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
UpdateAutofeedSettings

rpc UpdateAutofeedSettings(UpdateAutofeedSettingsRequest) returns (AutofeedSettings)

تعديل إعدادات الخلاصة التلقائية لحساب

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

BusinessIdentityService

خدمة لدعم واجهة برمجة تطبيقات business identity

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

يسترجع هوية النشاط التجاري لحساب معيّن.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

تعديل هوية النشاط التجاري لحساب معيّن يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

BusinessInfoService

خدمة لدعم واجهة برمجة التطبيقات لمعلومات النشاط التجاري

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

تستردّ معلومات النشاط التجاري لحساب معيّن.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

تعديل معلومات النشاط التجاري لحساب معيّن يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

EmailPreferencesService

خدمة تتيح استخدام واجهة برمجة التطبيقات EmailPreferences

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

تعرِض هذه السمة الإعدادات المفضّلة للبريد الإلكتروني لمستخدم حساب على Merchant Center. لا تسمح هذه الخدمة إلا باسترداد وتحديث الإعدادات المفضّلة للبريد الإلكتروني للمستخدم الذي تمّت مصادقة هويته. استخدِم العنوان البديل name=accounts/*/users/me/emailPreferences للحصول على الإعدادات المفضّلة للمستخدم الذي تمّت مصادقة هويته.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

تعديل الإعدادات المفضّلة للبريد الإلكتروني لمستخدم حساب على Merchant Center على مستخدمي الحساب المتعدّد العملاء تحديد حساب MCA بدلاً من حساب فرعي للحساب المتعدّد العملاء.

لن يتم تعديل الإعدادات المفضّلة التي لم يتم اختيارها صراحةً في قناع التعديل.

من غير الصالح أن تحدّد التعديلات قيمة حالة تفعيل غير مؤكَّدة.

استخدِم العنوان البديل name=accounts/*/users/me/emailPreferences لتعديل الإعدادات المفضّلة للمستخدم الذي تمّت مصادقة هويته.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

HomepageService

خدمة تتيح استخدام واجهة برمجة تطبيقات للصفحة الرئيسية للمتجر

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

يُستخدَم للمطالبة بالصفحة الرئيسية لمتجر. يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

إذا سبق أن تمّت المطالبة بالموقع الإلكتروني الرئيسي، سيؤدي ذلك إلى إعادة التحقّق من عملية إثبات الهوية (ما لم يكن التاجر معفىً من المطالبة بالموقع الإلكتروني، ما يُعفيه أيضًا من إثبات الهوية) وعرض استجابة ناجحة. إذا تعذّر إثبات الملكية، ستظهر رسالة خطأ، ولكن لن يتمّ إلغاء المطالبة. في حال تعذّر إكمال العملية، ستظهر رسالة خطأ أساسية: * PERMISSION_DENIED: لا يملك المستخدم الأذونات اللازمة في حساب Merchant Center هذا. * FAILED_PRECONDITION: - الحساب ليس حسابًا على Merchant Center. - لا يحتوي حساب Merchant Center على صفحة رئيسية. - تعذّر المطالبة (في هذه الحالة، ستتضمّن رسالة الخطأ المزيد من التفاصيل).

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

يسترجع الصفحة الرئيسية لمتجر.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

إلغاء المطالبة بالصفحة الرئيسية لمتجر يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

تعديل الصفحة الرئيسية لمتجر يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

OnlineReturnPolicyService

تسهّل الخدمة إدارة إعدادات سياسة الإرجاع بسبب ندم التاجر، بما في ذلك سياسات الإرجاع لكلّ من الإعلانات والبيانات المجانية.

البرامج. تحدِّد واجهة برمجة التطبيقات هذه نموذج الموارد التالي:

[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

الحصول على سياسة إرجاع حالية لتاجر معيّن

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

تعرض هذه السمة جميع سياسات الإرجاع الحالية لتاجر معيّن.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

ProgramsService

خدمة لإدارة البرنامج

توفّر البرامج آلية لإضافة وظائف إلى حسابات التجار. ومن الأمثلة الشائعة على ذلك برنامج البيانات المجانية للمنتجات الذي يتيح عرض المنتجات من متجر التاجر على مختلف خدمات Google مجانًا.

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

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

إيقاف المشاركة في البرنامج المحدّد للحساب يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

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

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

يسترجع البرنامج المحدّد للحساب.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

يسترجع جميع البرامج للحساب.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

RegionsService

تُدير إعدادات المناطق.

تحدِّد واجهة برمجة التطبيقات هذه نموذج الموارد التالي:

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

تُنشئ تعريفًا لمنطقة في حسابك على Merchant Center. يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

يؤدي هذا الإجراء إلى حذف تعريف منطقة من حسابك على Merchant Center. يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

يسترجع منطقة محدّدة في حسابك على Merchant Center.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

تعرض هذه السمة المناطق في حسابك على Merchant Center.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

تعديل تعريف منطقة في حسابك على Merchant Center يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

ShippingSettingsService

خدمة للحصول على معلومات إعدادات الشحن في طلب البيانات لكل طريقة في Merchant API

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

استرداد معلومات إعدادات الشحن

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

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

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

TermsOfServiceAgreementStateService

خدمة متوافقة مع واجهة برمجة التطبيقات TermsOfServiceAgreementState

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

تعرِض هذه السمة حالة اتفاقية بنود الخدمة.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

يسترجع حالة الاتفاقية لبنود خدمة التطبيق.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

TermsOfServiceService

خدمة متوافقة مع واجهة برمجة التطبيقات TermsOfService

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

يقبل TermsOfService. يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

يسترجع TermsOfService المرتبط بالإصدار المقدَّم.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

يسترجع أحدث إصدار من TermsOfService لـ kind وregion_code المحدّدَين.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

UserService

خدمة لدعم واجهة برمجة التطبيقات للمستخدم

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

لإنشاء مستخدم لحساب على Merchant Center يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

تؤدي هذه العملية إلى حذف مستخدم حساب على Merchant Center. يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف. لا يمكن أن يكون المستخدم المراد حذفه هو آخر مشرف في هذا الحساب. ويتم أيضًا حماية المستخدم من الحذف إذا كان مُدارًا من خلال "مركز إدارة النشاط التجاري".

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
GetUser

rpc GetUser(GetUserRequest) returns (User)

استرداد مستخدم حساب على Merchant Center

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

يعرض جميع مستخدمي حساب على Merchant Center.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

تعديل مستخدم حساب على Merchant Center يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

AcceptTermsOfServiceRequest

رسالة طلب لطريقة AcceptTermsOfService

الحقول
name

string

مطلوب. اسم المورد لنسخة بنود الخدمة. التنسيق: termsOfService/{version}
account

string

مطلوب. الحساب المطلوب قبول بنود الخدمة له
region_code

string

مطلوب. رمز المنطقة كما هو محدّد في CLDR يشير هذا الحقل إلى بلد عندما تنطبق بنود الخدمة على ذلك البلد تحديدًا أو 001 عندما تنطبق على مستوى العالم.

عدد الرسائل المقبولة

يصف بنود الخدمة المقبولة.

الحقول
terms_of_service

string

termsOfService المقبولة
accepted_by

string

الحساب الذي تم تسجيل القبول فيه ويمكن أن يكون هذا الحساب نفسه أو حساب MCA في حال الحسابات الفرعية.
valid_until

Date

عند ضبط هذا الإعداد، يُشير إلى أنّ TermsOfService المقبولة صالحة فقط حتى نهاية هذا التاريخ (بالتوقيت العالمي المنسَّق). ويجب قبول سياسة جديدة قبل ذلك التاريخ. يمكن العثور على معلومات TermsOfService المطلوبة في رسالة Required.

AccessRight

إذن الوصول.

عمليات التعداد
ACCESS_RIGHT_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
STANDARD أذونات الوصول العادية
ADMIN حقوق الوصول الإداري
PERFORMANCE_REPORTING يمكن للمستخدمين الذين لديهم هذا الحق الوصول إلى الأداء والإحصاءات.

Account

تمثّل رسالة Account حساب تاجر ضمن إعلانات Shopping. وهو الكيان الأساسي لإدارة بيانات المنتجات والإعدادات والتفاعلات مع خدمات Google ومقدّمي الخدمات الخارجيين.

يمكن أن تعمل الحسابات ككيانات مستقلة أو أن تكون جزءًا من بنية حساب متعدّد العملاء. في عملية إعداد الحساب المتعدّد العملاء، يدير الحساب الرئيسي حسابات فرعية متعددة.

يتضمن إنشاء حساب ضبط سمات مثل اسم الحساب والمنطقة الزمنية والإعدادات المفضّلة للغة.

رسالة Account هي العنصر الرئيسي للعديد من الموارد الأخرى، مثل AccountRelationship وHomepage وBusinessInfo وما إلى ذلك.

الحقول
name

string

المعرّف اسم المورد للحساب التنسيق: accounts/{account}
account_id

int64

النتائج فقط. رقم تعريف الحساب.
account_name

string

مطلوب. اسم الحساب السهل القراءة اطّلِع على اسم المتجر واسم النشاط التجاري للحصول على مزيد من المعلومات.
adult_content

bool

لتحديد ما إذا كان هذا الحساب يتضمّن محتوًى للبالغين.
test_account

bool

النتائج فقط. ما إذا كان هذا حسابًا اختباريًا
time_zone

TimeZone

مطلوب. المنطقة الزمنية للحساب.

عند الكتابة، يضبط time_zone كلّ من reporting_time_zone وdisplay_time_zone.

بالنسبة إلى عمليات القراءة، يعرض time_zone دائمًا display_time_zone. إذا لم يكن display_time_zone متوفّرًا لحسابك، تكون قيمة time_zone فارغة.
language_code

string

مطلوب. رمز اللغة وفق معيار BCP-47 للحساب، مثل en-US أو sr-Latn

AccountAggregation

لا يحتوي هذا النوع على أي حقول.

AccountAggregation payload.

AccountIssue

AccountIssue

الحقول
name

string

المعرّف اسم المورد لمشكلة الحساب التنسيق: accounts/{account}/issues/{id}
title

string

العنوان المترجَم للمشكلة
severity

Severity

درجة خطورة المشكلة بشكل عام
impacted_destinations[]

ImpactedDestination

تأثير هذه المشكلة في وجهات مختلفة
detail

string

تفاصيل إضافية مترجَمة عن المشكلة
documentation_uri

string

رابط يؤدي إلى مركز مساعدة Merchant Center يقدّم مزيدًا من المعلومات عن المشكلة وكيفية حلّها

ImpactedDestination

تأثير المشكلة في وجهة معيّنة

الحقول
impacts[]

Impact

التأثير (السلبي) للمناطق المختلفة في الوجهة المحدّدة.
reporting_context

ReportingContextEnum

سياق إعداد التقارير المتأثر

التأثير

تأثير المشكلة في منطقة معيّنة

الحقول
region_code

string

رمز CLDR للمنطقة التي تنطبق عليها هذه المشكلة
severity

Severity

شدة المشكلة في الوجهة والمنطقة

درجة الخطورة

جميع مستويات شدة المشاكل المحتملة

عمليات التعداد
SEVERITY_UNSPECIFIED شدة الخطأ غير معروفة.
CRITICAL تؤدي المشكلة إلى عدم عرض العروض.
ERROR قد تؤثّر المشكلة في العروض (في المستقبل) أو قد تكون مؤشرًا على مشاكل في العروض.
SUGGESTION المشكلة هي اقتراح لتحسين الأداء.

العنوان

عنوان الشحن للمستودع

الحقول
street_address

string

الجزء الذي يقع على مستوى الشارع من العنوان على سبيل المثال: 111w 31st Street.
city

string

مطلوب. مدينة أو بلدة أو بلدية وقد تشمل أيضًا المحليات أو المحليات الفرعية التابعة (مثل الأحياء أو الضواحي).
administrative_area

string

مطلوب. التقسيم الإداري الفرعي الأعلى للبلدة على سبيل المثال، ولاية مثل كاليفورنيا ("CA") أو مقاطعة مثل كيبك ("QC").
postal_code

string

مطلوب. الرمز البريدي (مثلاً 94043)
region_code

string

مطلوب. رمز البلد وفقًا لـ CLDR (على سبيل المثال، "US")

AutofeedSettings

جمع المعلومات ذات الصلة بإعدادات الخلاصة التلقائية

الحقول
name

string

المعرّف اسم المورد لإعدادات الخلاصة التلقائية. التنسيق: accounts/{account}/autofeedSettings
enable_products

bool

مطلوب. تفعيل أو إيقاف الزحف إلى المنتجات من خلال الخلاصة التلقائية للحساب المحدّد يجب أن تستوفي حسابات الخلاصة التلقائية شروطًا معيّنة، ويمكن التحقّق منها من خلال حقل eligible. يجب ألّا يكون الحساب سوقًا. عند تفعيل الخلاصة التلقائية للمرة الأولى، تظهر المنتجات عادةً على الفور. عند إعادة تفعيلها، قد يستغرق ظهور المنتجات مدة تصل إلى 24 ساعة.
eligible

bool

النتائج فقط. يحدِّد ما إذا كان التاجر مؤهّلاً للتسجيل في خلاصة تلقائية.

BusinessDayConfig

أيام عمل المخزن

الحقول
business_days[]

Weekday

مطلوب. أيام العمل العادية يجب عدم ترك الحقل فارغًا.

أيام الأسبوع

عمليات التعداد
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

مجموعة من المعلومات المتعلّقة بهوية نشاط تجاري

الحقول
name

string

المعرّف اسم المرجع لهوية النشاط التجاري. التنسيق: accounts/{account}/businessIdentity
black_owned

IdentityAttribute

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

IdentityAttribute

اختيارية: تُحدِّد ما إذا كان النشاط التجاري يعرّف نفسه على أنّه مملوك من امرأة. لن يتوفّر هذا الحقل الاختياري إلا للتجّار الذين تم ضبط بلد النشاط التجاري لديهم على US. ولا ينطبق أيضًا على الأسواق أو البائعين في الأسواق.
veteran_owned

IdentityAttribute

اختيارية: تُستخدَم لتحديد ما إذا كان النشاط التجاري يعرّف نفسه على أنّه يملكه محارب قديم. لن يتوفّر هذا الحقل الاختياري إلا للتجّار الذين تم ضبط بلد النشاط التجاري لديهم على US. ولا ينطبق أيضًا على الأسواق أو البائعين في الأسواق.
latino_owned

IdentityAttribute

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

IdentityAttribute

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

IdentityAttribute

جميع المعلومات ذات الصلة بسمة الهوية

الحقول
identity_declaration

IdentityDeclaration

مطلوب. بيان الهوية لهذه السمة.

IdentityDeclaration

جميع الإعدادات الممكنة في ما يتعلق ببيان الهوية

عمليات التعداد
IDENTITY_DECLARATION_UNSPECIFIED القيمة التلقائية التي تشير إلى عدم إجراء أي اختيار
SELF_IDENTIFIES_AS يشير إلى أنّ الحساب يحدّد السمة.
DOES_NOT_SELF_IDENTIFY_AS يشير إلى أنّ الحساب لا يرتبط بالسمة.

PromotionsConsent

جميع الإعدادات الممكنة في ما يتعلّق بالعروض الترويجية المرتبطة بهوية النشاط التجاري

عمليات التعداد

BusinessInfo

تحتوي رسالة BusinessInfo على معلومات أساسية عن نشاط التاجر التجاري.

تتضمن هذه الرسالة تفاصيل النشاط التجاري الرئيسية، مثل العنوان الجغرافي ومعلومات الاتصال بخدمة العملاء والمعرّفات الخاصة بالمنطقة.

الحقول
name

string

المعرّف اسم المرجع لمعلومات النشاط التجاري. التنسيق: accounts/{account}/businessInfo
address

PostalAddress

اختيارية: عنوان النشاط التجاري. لا تتوفّر سوى الحقول region_code وaddress_lines وpostal_code وadministrative_area وlocality. ويتم تجاهل جميع الحقول الأخرى.
phone

PhoneNumber

النتائج فقط. رقم هاتف النشاط التجاري
phone_verification_state

PhoneVerificationState

النتائج فقط. حالة إثبات ملكية النشاط التجاري عبر الهاتف
customer_service

CustomerService

اختيارية: خدمة عملاء النشاط التجاري
korean_business_registration_number

string

اختيارية: رقم تسجيل النشاط التجاري في كوريا المكوّن من 10 أرقام مفصولاً بشرطات بالتنسيق: XXX-XX-XXXXX

CarrierRate

قائمة بأسعار مشغّلي شبكات الجوّال التي يمكن الإشارة إليها باستخدام main_table أو single_value يمكنك الاطّلاع على خدمات شركات النقل المتوافقة على الرابط https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.

الحقول
name

string

مطلوب. اسم تعرفة شركة النقل يجب أن يكون فريدًا لكل مجموعة تعرفات.
carrier

string

مطلوب. خدمة شركة النقل، مثل "UPS" أو "Fedex"
carrier_service

string

مطلوب. خدمة شركة النقل، مثل "ground" أو "2 days"
origin_postal_code

string

مطلوب. نقطة شحن سعر شركة النقل هذا.
percentage_adjustment

string

اختيارية: مُعدِّل سعر الشحن المُضاعِف كرقم بالتنسيق العشري يمكن أن تكون سالبة. على سبيل المثال، تزيد "5.4" معدّل الضريبة بنسبة %5.4، وتخفض "-3" معدّل الضريبة بنسبة %3.
flat_adjustment

Price

اختيارية: مُعدِّل تعرفة شحن إضافي يمكن أن تكون سالبة. على سبيل المثال، تضيف { "amount_micros": 1, "currency_code" : "USD" } دولارًا أمريكيًا واحدًا إلى السعر، وتزيل { "amount_micros": -3, "currency_code" : "USD" } 3 دولارات أمريكية من السعر.

ClaimHomepageRequest

رسالة طلب لطريقة ClaimHomepage

الحقول
name

string

مطلوب. اسم الصفحة الرئيسية المطلوب المطالبة بها التنسيق: accounts/{account}/homepage
overwrite

bool

اختيارية: عند ضبط هذا الخيار على true، يزيل هذا الخيار أي مطالبة حالية على الموقع الإلكتروني المطلوب ويستبدلها بمطالبات من الحساب الذي يقدّم الطلب.

CreateAndConfigureAccountRequest

رسالة طلب لطريقة CreateAndConfigureAccount

الحقول
account

Account

مطلوب. الحساب المطلوب إنشاؤه.
users[]
(deprecated)

CreateUserRequest

اختيارية: المستخدمون الذين ستتم إضافتهم إلى الحساب

تم إيقاف هذا الحقل نهائيًا ولن يكون متوفّرًا بعد أن تصبح واجهة برمجة التطبيقات متوفّرة خارج الإصدار التجريبي. استخدِم الحقل user بدلاً من ذلك.
user[]

AddUser

اختيارية: المستخدمون الذين ستتم إضافتهم إلى الحساب
service[]

AddAccountService

مطلوب. يتمّ إعداد خدمة حساب بين الحساب الذي سيتمّ إنشاؤه وحساب مقدّم الخدمة كجزء من عملية الإنشاء. يجب تقديم خدمة واحدة على الأقل من هذه الخدمات. يجب أن يكون أحدهما حاليًا account_aggregation، ما يعني أنّه يمكنك إنشاء حسابات فرعية فقط، وليس حسابًا مستقلاً من خلال هذه الطريقة. قد يتم توفير خدمات account_management أو product_management إضافية.

AddAccountService

تعليمات إضافية لإضافة خدمات الحساب أثناء إنشاء الحساب

الحقول
حقل الربط service_type نوع الخدمة المطلوب إضافته يمكن أن يكون service_type واحدًا مما يلي فقط:
account_aggregation

AccountAggregation

يكون مقدّم الخدمة مجمّعًا للحساب. الحمولة لنوع الخدمة "تجميع الحسابات"
provider

string

مطلوب. مقدّم الخدمة إما الإشارة إلى حساب مثل providers/123 أو مقدّم خدمة معروف (أحد providers/GOOGLE_ADS أو providers/GOOGLE_BUSINESS_PROFILE).

AddUser

تعليمات لإضافة مستخدم إلى الحساب أثناء إنشائه

الحقول
user_id

string

مطلوب. عنوان البريد الإلكتروني للمستخدم (على سبيل المثال، john.doe@gmail.com)
user

User

اختيارية: تفاصيل عن المستخدم الذي سيتمّت إضافته في الوقت الحالي، يمكن تحديد أذونات الوصول فقط.

CreateRegionRequest

رسالة طلب لطريقة CreateRegion

الحقول
parent

string

مطلوب. الحساب الذي تريد إنشاء منطقة له. التنسيق: accounts/{account}
region_id

string

مطلوب. معرّف المنطقة، وهو فريد في جميع مناطق الحساب نفسه.
region

Region

مطلوب. المنطقة المطلوب إنشاؤها.

CreateUserRequest

رسالة طلب لطريقة CreateUser

الحقول
parent

string

مطلوب. اسم المورد للحساب الذي سيتم إنشاء مستخدم له. التنسيق: accounts/{account}
user_id

string

مطلوب. عنوان البريد الإلكتروني للمستخدم (على سبيل المثال، john.doe@gmail.com)
user

User

اختيارية: المستخدم المطلوب إنشاؤه.

CustomerService

معلومات خدمة العملاء

الحقول
uri

string

اختيارية: عنوان URL الذي يمكن العثور فيه على خدمة العملاء
email

string

اختيارية: عنوان البريد الإلكتروني الذي يمكن التواصل مع خدمة العملاء من خلاله
phone

PhoneNumber

اختيارية: رقم الهاتف الذي يمكن الاتصال به من أجل التواصل مع خدمة العملاء

CutoffTime

تعريف وقت الموعد النهائي لأيام العمل

الحقول
hour

int32

مطلوب. ساعة الموعد النهائي الذي يجب تقديم الطلب قبله لتتم معالجته في اليوم نفسه.
minute

int32

مطلوب. دقيقة من الموعد النهائي الذي يجب تقديم الطلب قبله لتتم معالجته في اليوم نفسه.
time_zone

string

مطلوب. معرّف المنطقة الزمنية، على سبيل المثال "أوروبا/القاهرة"

DeleteAccountRequest

رسالة طلب لطريقة DeleteAccount

الحقول
name

string

مطلوب. اسم الحساب المطلوب حذفه التنسيق: accounts/{account}
force

bool

اختيارية: في حال ضبط القيمة على true، يتم حذف الحساب حتى إذا كان يقدّم خدمات لحسابات أخرى أو كان قد عالج عروضًا.

DeleteRegionRequest

رسالة طلب لطريقة DeleteRegion

الحقول
name

string

مطلوب. اسم المنطقة المطلوب حذفها التنسيق: accounts/{account}/regions/{region}

DeleteUserRequest

رسالة طلب لطريقة DeleteUser

الحقول
name

string

مطلوب. اسم المستخدم المراد حذفه. التنسيق: accounts/{account}/users/{email}

من الممكن أيضًا حذف المستخدم المرتبط بالمتصل باستخدام me بدلاً من عنوان بريد إلكتروني كما هو موضّح في accounts/{account}/users/me.

DeliveryTime

الوقت الذي يقضيه العملاء في جوانب مختلفة بدءًا من طلب المنتج ووصولاً إلى تسليمه

الحقول
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

اختيارية: يشير ذلك إلى أنّه يجب احتساب مدة التسليم لكل مستودع (الموقع الجغرافي لمصدر الشحن) استنادًا إلى إعدادات شركة النقل المحدّدة. عند ضبط هذه السمة، يجب عدم ضبط أي حقل آخر مرتبط بمدة النقل في [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime].
min_transit_days

int32

الحد الأدنى لعدد أيام العمل التي يستغرقها الشحن يشير الرقم 0 إلى التوصيل في اليوم نفسه، ويشير الرقم 1 إلى التوصيل في اليوم التالي. يجب ضبط min_transit_days أو max_transit_days أو transit_time_table، ولكن ليس كليهما.
max_transit_days

int32

الحد الأقصى لعدد أيام العمل التي تستغرقها عملية الشحن يشير الرقم 0 إلى التوصيل في اليوم نفسه، ويشير الرقم 1 إلى التوصيل في اليوم التالي. يجب أن تكون أكبر من أو تساوي min_transit_days.
cutoff_time

CutoffTime

تعريف وقت الموعد النهائي لأيام العمل في حال عدم ضبط الوقت، سيتم ضبطه تلقائيًا على الساعة 8 صباحًا بتوقيت المحيط الهادئ.
min_handling_days

int32

الحد الأدنى لعدد أيام العمل التي يتم خلالها معالجة الطلب قبل شحنه يشير الرقم 0 إلى الشحن في اليوم نفسه، ويشير الرقم 1 إلى الشحن في اليوم التالي. يجب ضبط سمتَي min_handling_days وmax_handling_days أو عدم ضبطهما في الوقت نفسه.
max_handling_days

int32

الحد الأقصى لعدد أيام العمل التي يتم خلالها معالجة طلب قبل شحنه يشير الرقم 0 إلى الشحن في اليوم نفسه، ويشير الرقم 1 إلى الشحن في اليوم التالي. يجب أن تكون أكبر من أو تساوي min_handling_days. يجب ضبط السمتَين min_handling_days وmax_handling_days أو عدم ضبطهما في الوقت نفسه.
transit_time_table

TransitTable

جدول وقت النقل، عدد أيام العمل التي تستغرقها عملية النقل استنادًا إلى سمات الصف والعمود يمكن ضبط min_transit_days أو max_transit_days أو transit_time_table، ولكن ليس كليهما.
handling_business_day_config

BusinessDayConfig

أيام العمل التي يمكن خلالها معالجة الطلبات. في حال عدم تقديم هذه السمة، سيتم افتراض أنّ أيام العمل هي من الاثنين إلى الجمعة.
transit_business_day_config

BusinessDayConfig

أيام العمل التي يمكن أن تكون فيها الطلبات في مرحلة النقل. في حال عدم تقديم هذه السمة، سيتم افتراض أنّ أيام العمل هي من الاثنين إلى الجمعة.

DisableProgramRequest

رسالة طلب لطريقة DisableProgram

الحقول
name

string

مطلوب. اسم البرنامج المطلوب إيقاف المشاركة فيه للحساب المحدّد. التنسيق: accounts/{account}/programs/{program}

المسافة

أوسع نطاق جغرافي للتوصيل لا يكون هذا مطلوبًا إلا لنوع الشحنة للتوصيل داخل المتجر.

الحقول
value

int64

القيمة الصحيحة للمسافة
unit

Unit

يمكن أن تختلف الوحدة حسب البلد، ويتمّ ضبط مَعلماتها لتضمين الأميال والكيلومترات.

الوحدة

يمكن أن تختلف الوحدة حسب البلد، ويتمّ ضبط مَعلماتها لتضمين الأميال والكيلومترات.

عمليات التعداد
UNIT_UNSPECIFIED الوحدة غير محدّدة
MILES الوحدة بالميل
KILOMETERS الوحدة بالكيلومترات

EmailPreferences

فئات الإشعارات التي فعّلها المستخدم أو أوقفها لا تتضمّن الإعدادات المفضّلة للبريد الإلكتروني الإعلانات الإلزامية لأنّه لا يمكن للمستخدمين إيقافها.

الحقول
name

string

المعرّف اسم EmailPreferences. لا تتوفّر نقطة النهاية إلا للمستخدم الذي تمّت مصادقته.
news_and_tips

OptInState

اختيارية: آخر الأخبار حول الميزات الجديدة والنصائح وأفضل الممارسات

OptInState

حالة تفعيل إعدادات البريد الإلكتروني المفضّلة.

عمليات التعداد
OPT_IN_STATE_UNSPECIFIED لم يتم تحديد حالة الموافقة.
OPTED_OUT أوقف المستخدم تلقّي هذا النوع من الرسائل الإلكترونية.
OPTED_IN وافق المستخدم على تلقّي هذا النوع من الرسائل الإلكترونية.
UNCONFIRMED فعّل المستخدم تلقّي هذا النوع من الرسائل الإلكترونية وتم إرسال رسالة التأكيد الإلكترونية، ولكن لم يؤكد المستخدم تفعيل الميزة بعد (ينطبق ذلك على بلدان معيّنة فقط).

EnableProgramRequest

رسالة طلب لطريقة EnableProgram

الحقول
name

string

مطلوب. اسم البرنامج المطلوب تفعيل المشاركة فيه للحساب المحدّد. التنسيق: accounts/{account}/programs/{program}

GetAccountRequest

رسالة طلب لطريقة GetAccount

الحقول
name

string

مطلوب. اسم الحساب المطلوب استرجاعه التنسيق: accounts/{account}

GetAutofeedSettingsRequest

رسالة طلب لطريقة GetAutofeedSettings

الحقول
name

string

مطلوب. اسم المورد لإعدادات الخلاصة التلقائية. التنسيق: accounts/{account}/autofeedSettings

GetBusinessIdentityRequest

رسالة طلب لطريقة GetBusinessIdentity

الحقول
name

string

مطلوب. اسم المرجع لهوية النشاط التجاري. التنسيق: accounts/{account}/businessIdentity

GetBusinessInfoRequest

رسالة طلب لطريقة GetBusinessInfo

الحقول
name

string

مطلوب. اسم المرجع لمعلومات النشاط التجاري. التنسيق: accounts/{account}/businessInfo

GetEmailPreferencesRequest

رسالة طلب لطريقة GetEmailPreferences

الحقول
name

string

مطلوب. اسم مورد EmailPreferences التنسيق: accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

رسالة طلب لطريقة GetHomepage

الحقول
name

string

مطلوب. اسم الصفحة الرئيسية المطلوب استرجاعها. التنسيق: accounts/{account}/homepage

GetOnlineReturnPolicyRequest

رسالة طلب لطريقة GetOnlineReturnPolicy

الحقول
name

string

مطلوب. اسم سياسة الإرجاع المطلوب استرجاعها. التنسيق: accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

رسالة طلب لطريقة GetProgram

الحقول
name

string

مطلوب. اسم البرنامج المطلوب استرجاعه التنسيق: accounts/{account}/programs/{program}

GetRegionRequest

رسالة طلب لطريقة GetRegion

الحقول
name

string

مطلوب. اسم المنطقة المطلوب استرجاعها التنسيق: accounts/{account}/regions/{region}

GetShippingSettingsRequest

رسالة طلب لطريقة GetShippingSetting

الحقول
name

string

مطلوب. اسم إعداد الشحن المطلوب استرجاعه. التنسيق: accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

رسالة طلب لطريقة GetTermsOfServiceAgreementState

الحقول
name

string

مطلوب. اسم المورد لنسخة بنود الخدمة. التنسيق: accounts/{account}/termsOfServiceAgreementState/{identifier} تنسيق المعرّف هو: {TermsOfServiceKind}-{country}

GetTermsOfServiceRequest

رسالة طلب لطريقة GetTermsOfService

الحقول
name

string

مطلوب. اسم المورد لنسخة بنود الخدمة. التنسيق: termsOfService/{version}

GetUserRequest

رسالة طلب لطريقة GetUser

الحقول
name

string

مطلوب. اسم المستخدم المطلوب استرداده. التنسيق: accounts/{account}/users/{email}

من الممكن أيضًا استرداد المستخدم المقابل للمتصل باستخدام me بدلاً من عنوان البريد الإلكتروني كما هو موضّح في accounts/{account}/users/me.

العناوين

قائمة غير فارغة برؤوس الصفوف أو الأعمدة لجدول يجب ضبط قيمة واحدة فقط من prices أو weights أو num_items أو postal_code_group_names أو location.

الحقول
prices[]

Price

مطلوب. قائمة بالحدود العليا لأسعار الطلبات الشاملة يمكن أن تكون قيمة السعر الأخير بلا حدود من خلال ضبط price amount_micros = -1. على سبيل المثال، تمثّل السمة [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] العناوين "<= 10 دولار أمريكي" و"<= 500 دولار أمريكي" و "> 500 دولار أمريكي". يجب أن تكون جميع الأسعار ضمن الخدمة بالعملة نفسها. يجب ألا يكون فارغًا. يجب أن تكون موجبة باستثناء -1. لا يمكن ضبطه إلا إذا لم يتم ضبط جميع الحقول الأخرى.
weights[]

Weight

مطلوب. قائمة بالحدود العليا لوزن الطلبات الشاملة يمكن أن تكون قيمة آخر وزن غير محدودة من خلال ضبط price amount_micros = -1. على سبيل المثال، تمثّل السمة [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] العناوين "<= 10kg" و"<= 50kg" و "> 50kg". يجب أن تكون جميع الأوزان ضمن الخدمة بالوحدة نفسها. يجب ألا يكون فارغًا. يجب أن تكون موجبة باستثناء -1. لا يمكن ضبطه إلا إذا لم يتم ضبط جميع الحقول الأخرى.
number_of_items[]

string

مطلوب. قائمة بالحدود القصوى الشاملة لعدد العناصر يمكن أن تكون القيمة الأخيرة "infinity". على سبيل المثال، تمثّل السمة ["10", "50", "infinity"] العناوين "<= 10 سلع" و"<= 50 سلعة" و "> 50 سلعة". يجب ألا يكون فارغًا. لا يمكن ضبطه إلا إذا لم يتم ضبط جميع الحقول الأخرى.
postal_code_group_names[]

string

مطلوب. قائمة بأسماء المجموعات البريدية يمكن أن تكون القيمة الأخيرة "all other locations". مثال: ["zone 1", "zone 2", "all other locations"] يجب أن تتطابق مجموعات الرموز البريدية المُشار إليها مع بلد تسليم الخدمة. يجب ألا يكون فارغًا. لا يمكن ضبطه إلا إذا لم يتم ضبط جميع الحقول الأخرى.
locations[]

LocationIdSet

مطلوب. قائمة بمجموعات أرقام تعريف المواقع الجغرافية يجب ألا يكون فارغًا. لا يمكن ضبطه إلا إذا لم يتم ضبط جميع الحقول الأخرى.

الصفحة الرئيسية

تمثّل رسالة Homepage الصفحة الرئيسية لمتجر التاجر ضمن النظام.

الصفحة الرئيسية للتاجر هي النطاق الأساسي الذي يتفاعل فيه العملاء مع متجره.

يمكن المطالبة بالصفحة الرئيسية وإثبات ملكيتها كدليل على الملكية، ما يتيح للتاجر الاستفادة من الميزات التي تتطلّب موقعًا إلكترونيًا تم إثبات ملكيته. لمزيد من المعلومات، يُرجى الاطّلاع على فهم عملية إثبات ملكية عنوان URL للمتجر على الإنترنت.

الحقول
name

string

المعرّف اسم المورد لصفحة المتجر الرئيسية التنسيق: accounts/{account}/homepage
claimed

bool

النتائج فقط. ما إذا تمّت المطالبة بالصفحة الرئيسية يُرجى الاطّلاع على https://support.google.com/merchants/answer/176793.
uri

string

مطلوب. معرّف الموارد المنتظم (URI) (عادةً ما يكون عنوان URL) للصفحة الرئيسية للمتجر.

InsertShippingSettingsRequest

رسالة طلب لطريقة InsertShippingSetting

الحقول
parent

string

مطلوب. الحساب الذي سيتم إدراج هذا المنتج فيه. التنسيق: accounts/{account}
shipping_setting

ShippingSettings

مطلوب. النسخة الجديدة من الحساب.

ListAccountIssuesRequest

رسالة طلب لطريقة ListAccountIssues

الحقول
parent

string

مطلوب. العنصر الرئيسي الذي يملك هذه المجموعة من المشاكل التنسيق: accounts/{account}
page_size

int32

اختيارية: الحد الأقصى لعدد المشاكل المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد، سيتم عرض 50 مستخدمًا كحد أقصى. الحد الأقصى للقيمة هو 100، وسيتم تحويل القيم التي تزيد عن 100 إلى 100.
page_token

string

اختيارية: رمز مميّز للصفحة، تم تلقّيه من مكالمة ListAccountIssues سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة.

عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListAccountIssues مع الطلب الذي قدّم الرمز المميّز للصفحة.
language_code

string

اختيارية: ستتضمّن المشاكل في الردّ حقولًا يسهل على الإنسان قراءتها باللغة المحدّدة. يكون التنسيق BCP-47، مثل en-US أو sr-Latn. في حال عدم تقديم قيمة، سيتم استخدام en-US.
time_zone

string

اختيارية: المنطقة الزمنية IANA المستخدَمة لترجُم الأوقات في الحقول السهلة القراءة على سبيل المثال، "America/Los_Angeles". في حال عدم ضبطها، سيتم استخدام "America/Los_Angeles".

ListAccountIssuesResponse

رسالة الردّ لطريقة ListAccountIssues

الحقول
account_issues[]

AccountIssue

المشاكل من الحساب المحدّد
next_page_token

string

رمز مميّز يمكن إرساله على شكل page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListAccountsRequest

رسالة طلب لطريقة ListAccounts

الحقول
page_size

int32

اختيارية: الحدّ الأقصى لعدد الحسابات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد، يتم عرض 250 حسابًا بحد أقصى. الحدّ الأقصى للقيمة هو 500، ويتمّ تحويل القيم التي تزيد عن 500 إلى 500.
page_token

string

اختيارية: رمز مميّز للصفحة، تم تلقّيه من مكالمة ListAccounts سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة.

عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListAccounts مع الطلب الذي قدّم الرمز المميّز للصفحة.
filter

string

اختيارية: لا تعرض سوى الحسابات التي تتطابق مع الفلتر. لمزيد من التفاصيل، راجِع مرجع بنية الفلتر.

ListAccountsResponse

رسالة الردّ على طريقة ListAccounts

الحقول
accounts[]

Account

الحسابات التي تتطابق مع ListAccountsRequest
next_page_token

string

رمز مميّز يمكن إرساله على شكل page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListOnlineReturnPoliciesRequest

رسالة طلب لطريقة ListOnlineReturnPolicies

الحقول
parent

string

مطلوب. حساب التاجر المطلوب إدراج سياسات الإرجاع له. التنسيق: accounts/{account}
page_size

int32

اختيارية: الحد الأقصى لعدد موارد OnlineReturnPolicy المطلوب عرضها تعرِض الخدمة عددًا أقل من هذه القيمة إذا كان عدد سياسات الإرجاع للتاجر المحدّد أقل من pageSize. القيمة التلقائية هي 10. الحد الأقصى للقيمة هو 100. إذا تم تحديد قيمة أعلى من الحد الأقصى، سيتم ضبط pageSize تلقائيًا على الحد الأقصى.
page_token

string

اختيارية: رمز مميّز للصفحة، تم تلقّيه من مكالمة ListOnlineReturnPolicies سابقة قدِّم رمز علامة الصفحة لاسترداد الصفحة اللاحقة.

عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListOnlineReturnPolicies مع الطلب الذي قدّم الرمز المميّز للصفحة. تم عرض الرمز المميّز على أنّه nextPageToken في ردّ على الطلب السابق.

ListOnlineReturnPoliciesResponse

رسالة الردّ على طريقة ListOnlineReturnPolicies

الحقول
online_return_policies[]

OnlineReturnPolicy

سياسات الإرجاع التي تم استرجاعها
next_page_token

string

رمز مميّز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListProgramsRequest

رسالة طلب لطريقة ListPrograms

الحقول
parent

string

مطلوب. اسم الحساب المطلوب استرداد جميع البرامج له التنسيق: accounts/{account}
page_size

int32

اختيارية: الحد الأقصى لعدد البرامج التي سيتم عرضها في ردّ واحد في حال عدم تحديد قيمة (أو 0)، يتم استخدام الحجم التلقائي الذي يبلغ 1000. الحد الأقصى للقيمة هو 1000، وسيتم تحويل القيم التي تزيد عن 1000 إلى 1000.
page_token

string

اختيارية: رمز مميّز للمتابعة، تم تلقّيه من مكالمة ListPrograms سابقة يجب تقديم هذا المرجع لاسترداد الصفحة التالية.

ListProgramsResponse

رسالة الاستجابة لطريقة ListPrograms

الحقول
programs[]

Program

البرامج للحساب المحدّد
next_page_token

string

رمز مميّز يمكن إرساله على شكل page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListRegionsRequest

رسالة طلب لطريقة ListRegions

الحقول
parent

string

مطلوب. الحساب الذي تريد إدراج المناطق له. التنسيق: accounts/{account}
page_size

int32

اختيارية: الحد الأقصى لعدد المناطق التي سيتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 50 منطقة كحدّ أقصى. الحد الأقصى للقيمة هو 1000، وسيتم تحويل القيم التي تزيد عن 1000 إلى 1000.
page_token

string

اختيارية: رمز مميّز للصفحة، تم تلقّيه من مكالمة ListRegions سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة.

عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListRegions مع الطلب الذي قدّم الرمز المميّز للصفحة.

ListRegionsResponse

رسالة الردّ على طريقة ListRegions

الحقول
regions[]

Region

المناطق من التاجر المحدّد
next_page_token

string

رمز مميّز يمكن إرساله على شكل page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListSubAccountsRequest

رسالة طلب لطريقة ListSubAccounts

الحقول
provider

string

مطلوب. مقدّم خدمة التجميع التنسيق: providers/{providerId}
page_size

int32

اختيارية: الحدّ الأقصى لعدد الحسابات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد، يتم عرض 250 حسابًا كحد أقصى. الحدّ الأقصى للقيمة هو 500، ويتمّ تحويل القيم التي تزيد عن 500 إلى 500.
page_token

string

اختيارية: رمز مميّز للصفحة، تم تلقّيه من مكالمة ListAccounts سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة.

عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListAccounts مع الطلب الذي قدّم الرمز المميّز للصفحة.

ListSubAccountsResponse

رسالة الردّ على طريقة ListSubAccounts

الحقول
accounts[]

Account

الحسابات التي يجمع حساب رئيسي معيّن بياناتها
next_page_token

string

رمز مميّز يمكن إرساله على شكل page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListUsersRequest

رسالة طلب لطريقة ListUsers

الحقول
parent

string

مطلوب. العنصر الرئيسي الذي يملك هذه المجموعة من المستخدمين. التنسيق: accounts/{account}
page_size

int32

اختيارية: الحد الأقصى لعدد المستخدمين المطلوب عرضهم قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد، سيتم عرض 50 مستخدمًا كحد أقصى. الحد الأقصى للقيمة هو 100، وسيتم تحويل القيم التي تزيد عن 100 إلى 100.
page_token

string

اختيارية: رمز مميّز للصفحة، تم تلقّيه من مكالمة ListUsers سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة.

عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListUsers مع الطلب الذي قدّم الرمز المميّز للصفحة.

ListUsersResponse

رسالة الردّ على طريقة ListUsers

الحقول
users[]

User

المستخدمون من الحساب المحدّد
next_page_token

string

رمز مميّز يمكن إرساله على شكل page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

LocationIdSet

قائمة بمجموعات أرقام تعريف المواقع الجغرافية يجب ألا يكون فارغًا. لا يمكن ضبطه إلا إذا لم يتم ضبط جميع الحقول الأخرى.

الحقول
location_ids[]

string

مطلوب. قائمة غير فارغة من معرّفات المواقع الجغرافية ويجب أن تكون جميعها من نوع الموقع الجغرافي نفسه (مثل الولاية).

MinimumOrderValueTable

جدول يعرض الحد الأدنى لقيم طلبات الشراء لكل متجر لنوع خدمة استلام الطلب.

الحقول
store_code_set_with_movs[]

StoreCodeSetWithMov

مطلوب. قائمة بمجموعات رموز المتاجر التي تتشارك الحدّ الأدنى نفسه لقيمة طلب الشراء يجب توفّر مجموعتَين على الأقل ويجب أن تكون المجموعة الأخيرة فارغة، ما يشير إلى "MOV لجميع المتاجر الأخرى". يمكن أن يظهر كل رمز متجر مرة واحدة فقط في جميع المجموعات. يجب أن تكون جميع الأسعار ضمن الخدمة بالعملة نفسها.

StoreCodeSetWithMov

قائمة بمجموعات رموز المتاجر التي تتشارك الحد الأدنى نفسه لقيمة طلب الشراء يجب توفّر مجموعتَين على الأقل ويجب أن تكون المجموعة الأخيرة فارغة، ما يشير إلى "MOV لجميع المتاجر الأخرى". يمكن أن يظهر كل رمز متجر مرة واحدة فقط في جميع المجموعات. يجب أن تكون جميع الأسعار ضمن الخدمة بالعملة نفسها.

الحقول
store_codes[]

string

اختيارية: قائمة برموز متاجر فريدة أو فارغة للعنوان التلقائي
value

Price

الحد الأدنى لقيمة طلب الشراء في المتاجر المحدّدة

OnlineReturnPolicy

عنصر سياسة الإرجاع على الإنترنت ويُستخدَم هذا الحقل حاليًا لتمثيل سياسات الإرجاع للإعلانات وبرامج البيانات المجانية.

الحقول
name

string

المعرّف اسم مورد OnlineReturnPolicy التنسيق: accounts/{account}/onlineReturnPolicies/{return_policy}
return_policy_id

string

النتائج فقط. رقم تعريف سياسة الإرجاع الذي أنشأته Google
label

string

مطلوب. غير قابل للتغيير يمثّل هذا الحقل التصنيف الفريد الذي يحدّده المستخدم لسياسة الإرجاع. يُرجى العلم أنّه لا يمكن استخدام التصنيف نفسه في سياسات إرجاع مختلفة للبلد نفسه. ما لم يحدّد المنتج سمة تصنيف معيّنة، سيتم تصنيف السياسات تلقائيًا على أنّها "تلقائية". لتخصيص سياسة إرجاع مخصّصة لمجموعات منتجات معيّنة، اتّبِع التعليمات الواردة في تصنيف سياسة الإرجاع. يمكن أن يحتوي التصنيف على 50 حرفًا كحد أقصى.
countries[]

string

مطلوب. غير قابل للتغيير بلدان البيع التي تنطبق عليها سياسة الإرجاع يجب أن تكون القيم رمزًا صالحًا مكوّنًا من حرفَين وفقًا لمعيار ISO 3166.
policy

Policy

سياسة الإرجاع
seasonal_overrides[]

SeasonalOverride

اختيارية: استثناءات للسياسة العامة للطلبات التي تم تقديمها خلال مجموعة محدّدة من الفواصل الزمنية
restocking_fee

RestockingFee

رسوم إعادة التخزين التي تنطبق على جميع فئات أسباب الإرجاع سيتم التعامل مع هذه القيمة على أنّها رسوم إعادة تخزين مجانية في حال عدم ضبط القيمة.
return_methods[]

ReturnMethod

طرق إرجاع السلع التي يمكن للعملاء من خلالها إرجاع سلعة. يجب ألا تكون هذه القيمة فارغة ما لم يكن نوع سياسة الإرجاع هو noReturns.
item_conditions[]

ItemCondition

يجب ألا تكون حالة السلع المقبولة للإرجاع فارغة ما لم يكن نوع سياسة الإرجاع هو noReturns.
return_shipping_fee

ReturnShippingFee

رسوم شحن الإرجاع يجب ضبط هذا الخيار فقط عندما يحتاج العميل إلى تنزيل ملصق الإرجاع وطباعته.
return_policy_uri

string

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

bool

يحدّد هذا الحقل ما إذا كان التاجر يقبل إرجاع المنتجات التي تتضمّن عيوبًا فقط، وهو حقل مطلوب.
process_refund_days

int32

يحدّد الحقل عدد الأيام التي يستغرقها التجّار لمعالجة عمليات ردّ الأموال، وهو حقل اختياري.
accept_exchange

bool

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

ItemCondition

حالات السلع المتوفّرة

عمليات التعداد
ITEM_CONDITION_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
NEW جديد.
USED تم استخدامها.

السياسة

السياسات المتاحة

الحقول
type

Type

نوع السياسة
days

int64

عدد الأيام التي يمكن خلالها إرجاع السلع بعد التسليم، حيث يتم تعريف يوم واحد على أنّه 24 ساعة بعد الطابع الزمني للتسليم مطلوب لإرجاع NUMBER_OF_DAYS_AFTER_DELIVERY.

النوع

أنواع سياسات الإرجاع

عمليات التعداد
TYPE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
NUMBER_OF_DAYS_AFTER_DELIVERY عدد الأيام التي يكون فيها الإرجاع صالحًا بعد التسليم
NO_RETURNS لا يمكن إرجاع المشتريات.
LIFETIME_RETURNS يمكن إرجاع المشتريات في أي وقت.

RestockingFee

رسوم إعادة التخزين ويمكن أن تكون هذه الرسوم ثابتة أو نسبة مئوية صغيرة.

الحقول

حقل الربط type

يمكن أن يكون type واحدًا مما يلي فقط:
fixed_fee

Price

رسوم ثابتة لإعادة التخزين
micro_percent

int32

النسبة المئوية لإجمالي السعر بالمايكرو يعني الرقم 15,000,000 أنّه سيتم تحصيل ‎15% من السعر الإجمالي.

ReturnMethod

طرق الإرجاع المتاحة

عمليات التعداد
RETURN_METHOD_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
BY_MAIL الإرجاع عبر البريد
IN_STORE الإرجاع في المتجر
AT_A_KIOSK يمكنك إرجاع الجهاز في كشك.

ReturnShippingFee

رسوم شحن الإرجاع يمكن أن تكون هذه الرسوم ثابتة أو منطقية للإشارة إلى أنّ العميل يدفع تكلفة الشحن الفعلية.

الحقول
type

Type

مطلوب. نوع رسوم شحن الإرجاع
fixed_fee

Price

مبلغ ثابت لرسوم شحن السلع المرجَعة لا تنطبق هذه القيمة إلا عندما يكون النوع FIXED. سنعتبر رسوم شحن الإرجاع مجانية إذا كان النوع هو FIXED ولم يتم ضبط هذه القيمة.

النوع

أنواع رسوم شحن السلع المرجَعة

عمليات التعداد
TYPE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
FIXED تكون رسوم شحن الإرجاع قيمة ثابتة.
CUSTOMER_PAYING_ACTUAL_FEE سيدفع العملاء رسوم الشحن الفعلية للإرجاع.

SeasonalOverride

التالي: 5

الحقول
label

string

مطلوب. الاسم المعروض لهذا الإعدادات الموسمية في Merchant Center
begin

Date

مطلوب. تُحدِّد هذه السمة النطاق الزمني الذي ينطبق فيه هذا الاستثناء الموسمي. يشمل كلّ من تاريخ البدء والانتهاء اليوم المذكور، ويجب أن يكونا بالتنسيق العشري للتاريخ، مثل 20250115. يجب ألا تتداخل تواريخ الاستثناءات الموسمية.
end

Date

مطلوب. تاريخ انتهاء الاستثناء الموسمي (شامل).
policy

Policy

مطلوب. سياسة الإرجاع للنطاق الزمني المحدّد

PhoneVerificationState

حالة إثبات ملكية الهاتف.

عمليات التعداد
PHONE_VERIFICATION_STATE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
PHONE_VERIFICATION_STATE_VERIFIED تم إثبات ملكية الهاتف.
PHONE_VERIFICATION_STATE_UNVERIFIED لم يتم إثبات ملكية الهاتف

برامج

تحدِّد المشاركة في برنامج معيّن للحساب المحدّد.

توفّر البرامج آلية لإضافة وظائف إلى حسابات التجار. ومن الأمثلة الشائعة على ذلك برنامج البيانات المجانية للمنتجات الذي يتيح عرض المنتجات من متجر التاجر على مختلف خدمات Google مجانًا.

الحقول
name

string

المعرّف اسم المورد الخاص بالبرنامج التنسيق: accounts/{account}/programs/{program}
documentation_uri

string

النتائج فقط. عنوان URL لصفحة مساعدة في Merchant Center توضّح البرنامج
state

State

النتائج فقط. حالة مشاركة الحساب في البرنامج.
active_region_codes[]

string

النتائج فقط. المناطق التي يشارك فيها الحساب بنشاط في البرنامج يتم تعريف المناطق النشطة على أنّها المناطق التي تم استيفاء جميع متطلبات البرنامج التي تؤثر فيها.

يتم تحديد رموز المناطق من خلال CLDR. يشير هذا الحقل إلى بلد ينطبق فيه البرنامج على وجه التحديد أو 001 عندما ينطبق البرنامج على مستوى العالم.
unmet_requirements[]

Requirement

النتائج فقط. المتطلبات التي لم يستوفِها الحساب بعد والتي تؤثّر في المشاركة في البرنامج

المتطلبات

تُحدِّد متطلّبًا محدّدًا للمشاركة في البرنامج.

الحقول
title

string

النتائج فقط. اسم الشرط
documentation_uri

string

النتائج فقط. عنوان URL لصفحة مساعدة توضّح الشرط
affected_region_codes[]

string

النتائج فقط. المناطق المتأثّرة حاليًا بعدم استيفاء هذا الشرط

يتم تحديد رموز المناطق من خلال CLDR. يشير هذا الحقل إلى بلد ينطبق فيه البرنامج على وجه التحديد أو 001 عندما ينطبق البرنامج على مستوى العالم.

الحالة

حالات المشاركة المحتملة في البرنامج للحساب

عمليات التعداد
STATE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
NOT_ELIGIBLE الحساب غير مؤهَّل للمشاركة في البرنامج.
ELIGIBLE أن يكون الحساب مؤهلاً للمشاركة في البرنامج
ENABLED تم تفعيل البرنامج للحساب.

RateGroup

تعريفات مجموعات تعرفات الشحن يُسمح فقط للعنصر الأخير بملء applicable_shipping_labels فارغ، ما يعني "كل شيء آخر". يجب ألا تتداخل applicable_shipping_labels الأخرى.

الحقول
applicable_shipping_labels[]

string

مطلوب. قائمة بتصنيفات الحِزم التي تحدّد المنتجات التي تنطبق عليها مجموعة الأسعار هذه هذه عبارة نفي: يجب أن يتطابق تصنيف واحد فقط لكي يتم تطبيق مجموعة الأسعار. قد تكون فارغة فقط لمجموعة الأسعار الأخيرة لخدمة معيّنة.
subtables[]

Table

اختيارية: قائمة بالجداول الفرعية التي يشير إليها main_table لا يمكن ضبطه إلا إذا تم ضبط main_table.
carrier_rates[]

CarrierRate

اختيارية: قائمة بأسعار مشغّلي شبكات الجوّال التي يمكن الإشارة إليها باستخدام main_table أو single_value
single_value

Value

قيمة مجموعة الأسعار (على سبيل المثال، سعر ثابت بقيمة 10 ريال سعودي). لا يمكن ضبطه إلا إذا لم يتم ضبط main_table وsubtables.
main_table

Table

جدول يحدّد مجموعة الأسعار، عندما لا يكون single_value تعبيريًا بما يكفي لا يمكن ضبطه إلا إذا لم يتم ضبط single_value.
name

string

اختيارية: اسم مجموعة الأسعار إذا كان يجب أن تكون المجموعة فريدة ضمن خدمة الشحن.

المنطقة

تمثّل منطقة جغرافية يمكنك استخدامها كهدف مع كلّ من خدمتَي RegionalInventory وShippingSettings. يمكنك تحديد المناطق على أنّها مجموعات من الرموز البريدية أو باستخدام استهدافات جغرافية محدّدة مسبقًا في بعض البلدان. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد المناطق .

الحقول
name

string

المعرّف اسم المورد الخاص بالمنطقة التنسيق: accounts/{account}/regions/{region}
postal_code_area

PostalCodeArea

اختيارية: قائمة بالرموز البريدية التي تحدّد منطقة المنطقة
geotarget_area

GeoTargetArea

اختيارية: قائمة بأهداف جغرافية تحدّد منطقة المنطقة
regional_inventory_eligible

BoolValue

النتائج فقط. تشير إلى ما إذا كانت المنطقة مؤهّلة للاستخدام في إعدادات "المستودع الإقليمي".
shipping_eligible

BoolValue

النتائج فقط. تشير إلى ما إذا كانت المنطقة مؤهّلة للاستخدام في إعدادات "خدمات الشحن".
display_name

string

اختيارية: الاسم المعروض للمنطقة

GeoTargetArea

قائمة بأهداف جغرافية تحدّد منطقة المنطقة

الحقول
geotarget_criteria_ids[]

int64

مطلوب. قائمة غير فارغة من معرّفات المواقع الجغرافية ويجب أن تكون جميعها من نوع الموقع الجغرافي نفسه (مثل الولاية).

PostalCodeArea

قائمة بالرموز البريدية التي تحدّد منطقة المنطقة ملاحظة: يمكن الوصول إلى جميع المناطق المحدّدة باستخدام الرموز البريدية من خلال مورد ShippingSettings.postalCodeGroups للحساب.

الحقول
region_code

string

مطلوب. رمز CLDR للمنطقة أو البلد الذي تنطبق عليه مجموعة الرموز البريدية
postal_codes[]

PostalCodeRange

مطلوب. نطاق من الرموز البريدية

PostalCodeRange

نطاق من الرموز البريدية التي تحدّد منطقة المنطقة

الحقول
begin

string

مطلوب. رمز بريدي أو نمط بادئة النموذج* يشير إلى الحدّ الأدنى الشامل للنطاق الذي يحدّد المنطقة أمثلة على القيم: 94108 و9410* و9*.
end

string

اختيارية: رمز بريدي أو نمط من النوع prefix* يشير إلى الحدّ الأقصى الشامل للنطاق الذي يحدّد المنطقة يجب أن يكون طوله هو نفسه طول postalCodeRangeBegin: إذا كان postalCodeRangeBegin رمزًا بريديًا، يجب أن يكون postalCodeRangeEnd رمزًا بريديًا أيضًا. إذا كان postalCodeRangeBegin نمطًا، يجب أن يكون postalCodeRangeEnd نمطًا بطول البادئة نفسه. اختياري: في حال عدم ضبطه، يتمّ تحديد المنطقة على أنّها جميع الرموز البريدية التي تتطابق مع postalCodeRangeBegin.

مطلوب

يصف بنود الخدمة التي يجب قبولها.

الحقول
terms_of_service

string

termsOfService التي يجب قبولها
tos_file_uri

string

عنوان URL الكامل لملف بنود الخدمة هذا الحقل هو نفسه TermsOfService.file_uri، ويتمّ إضافته هنا للتيسير فقط.

RetrieveForApplicationTermsOfServiceAgreementStateRequest

رسالة طلب لطريقة RetrieveForApplicationTermsOfServiceAgreementState

الحقول
parent

string

مطلوب. الحساب المطلوب الحصول على تنسيق TermsOfServiceAgreementState له: accounts/{account}

RetrieveLatestTermsOfServiceRequest

رسالة طلب لطريقة RetrieveLatestTermsOfService

الحقول
region_code

string

مطلوب. رمز المنطقة كما هو محدّد في CLDR يشير هذا الحقل إلى بلد عندما تنطبق بنود الخدمة على ذلك البلد تحديدًا أو 001 عندما تنطبق على مستوى العالم.
kind

TermsOfServiceKind

مطلوب. النوع الذي ينطبق عليه إصدار بنود الخدمة هذا

الصف

أدرِج قائمة بالخلايا.

الحقول
cells[]

Value

مطلوب. قائمة الخلايا التي تشكّل الصف يجب أن يكون طولها مساويًا لطول columnHeaders للجداول ثنائية الأبعاد، ويجب أن يكون طولها 1 للجداول أحادية الأبعاد.

الخدمة

خدمة الشحن

الحقول
delivery_countries[]

string

مطلوب. رمز منطقة CLDR للبلدان التي تنطبق عليها الخدمة
rate_groups[]

RateGroup

اختيارية: تعريفات مجموعات تعرفات الشحن يُسمح فقط للعنصر الأخير بملء applicable_shipping_labels فارغ، ما يعني "كل شيء آخر". يجب ألا تتداخل applicable_shipping_labels الأخرى.
loyalty_programs[]

LoyaltyProgram

اختيارية: برامج الولاء التي تقتصر عليها خدمة الشحن هذه
service_name

string

مطلوب. اسم الخدمة بتنسيق حر يجب أن يكون فريدًا داخل الحساب المستهدَف.
active

bool

مطلوب. قيمة منطقية تعرض الحالة النشطة لخدمة الشحن
currency_code

string

رمز CLDR للعملة التي تنطبق عليها هذه الخدمة. يجب أن تتطابق مع أسعار مجموعات الأسعار.
delivery_time

DeliveryTime

مطلوب. الوقت الذي يقضيه العملاء في جوانب مختلفة بدءًا من طلب المنتج ووصولاً إلى تسليمه
shipment_type

ShipmentType

نوع المواقع الجغرافية التي تشحن هذه الخدمة الطلبات إليها
minimum_order_value

Price

الحد الأدنى لقيمة الطلب لهذه الخدمة. في حال ضبطها، تشير إلى أنّه على العملاء إنفاق هذا المبلغ على الأقل. يجب أن تكون جميع الأسعار ضمن الخدمة بالعملة نفسها. لا يمكن ضبطها مع minimum_order_value_table.
minimum_order_value_table

MinimumOrderValueTable

جدول يعرض الحد الأدنى لقيم طلبات الشراء لكل متجر لنوع خدمة استلام الطلب. لا يمكن ضبطها مع minimum_order_value.
store_config

StoreConfig

قائمة بالمتاجر التي يتم تسليم منتجاتك منها لا ينطبق ذلك إلا على نوع الشحن للتوصيل داخل المتجر.

LoyaltyProgram

برنامج الولاء الذي يوفّره التاجر

الحقول
loyalty_program_tiers[]

LoyaltyProgramTiers

اختيارية: فئة برنامج الولاء لخدمة الشحن هذه
program_label

string

تشير هذه السمة إلى تصنيف برنامج الولاء الذي تم ضبطه في إعدادات برنامج الولاء في Merchant Center. من خلال هذه السمة الفرعية، تتمكّن Google من ربط برنامج الولاء بالعروض المؤهَّلة.

LoyaltyProgramTiers

مجموعة فرعية من برنامج الولاء الخاص بالتجار

الحقول
tier_label

string

تُفرّق السمة الفرعية لتصنيف الفئة [tier_label] بين مزايا مستوى العرض لكل فئة. يتم ضبط هذه القيمة أيضًا في إعدادات برنامجك في Merchant Center، وهي مطلوبة لتغييرات مصدر البيانات حتى إذا كان برنامج الولاء يتضمّن مستوى واحدًا فقط.

ShipmentType

نوع الشحن لخدمة الشحن

عمليات التعداد
SHIPMENT_TYPE_UNSPECIFIED لم تحدّد هذه الخدمة نوع الشحنة.
DELIVERY تُرسِل هذه الخدمة الطلبات إلى عنوان يختاره العميل.
LOCAL_DELIVERY تُرسِل هذه الخدمة الطلبات إلى عنوان يختاره العميل. يتم شحن الطلب من متجر محلي قريب.
COLLECTION_POINT تُرسِل هذه الخدمة الطلبات إلى عنوان يختاره العميل. يتم شحن الطلب من نقطة استلام.

StoreConfig

قائمة بالمتاجر التي يتم تسليم منتجاتك منها لا ينطبق ذلك إلا على نوع الشحن للتوصيل داخل المتجر.

الحقول
store_codes[]

string

اختيارية: قائمة برموز المتاجر التي توفّر خدمة التوصيل داخل المتجر إذا كان الحقل فارغًا، يجب أن تكون قيمة all_stores صحيحة.
store_service_type

StoreServiceType

يشير إلى ما إذا كانت جميع المتاجر أو متاجر محدّدة يعرضها هذا التاجر توفّر خدمة التوصيل داخل المتجر.
cutoff_config

CutoffConfig

تنتهي الإعدادات المتعلّقة بالتسليم داخل المتجر في اليوم.
service_radius

Distance

أوسع نطاق جغرافي للتوصيل لا يكون هذا الإجراء مطلوبًا إلا لنوع الشحنة للتوصيل داخل المتجر.

CutoffConfig

تنتهي الإعدادات المتعلّقة بالتسليم داخل المتجر في اليوم.

الحقول
local_cutoff_time

LocalCutoffTime

الوقت الذي تنتهي فيه خدمة التسليم داخل المتجر لهذا اليوم.
store_close_offset_hours

int64

لا يمكن استخدامها إلا مع خدمة التوصيل داخل المتجر. يمثّل وقت الإغلاق عدد الساعات قبل إغلاق المتجر. متناقض مع local_cutoff_time
no_delivery_post_cutoff

bool

يمكن للتجّار إيقاف عرض ميزة التوصيل خلال n+1 يوم داخل المتجر إذا كانت لديهم خدمة شحن تم ضبطها على التوصيل خلال n يوم داخل المتجر. على سبيل المثال، إذا كانت خدمة الشحن تحدّد التوصيل في اليوم نفسه، وبعد انقضاء الموعد النهائي، يؤدي ضبط هذا الحقل على true إلى عرض تعرفة خدمة الشحن المحسوبة NO_DELIVERY_POST_CUTOFF. في المثال نفسه، يؤدي ضبط هذا الحقل على false إلى احتساب وقت الشحن على أنّه يوم واحد. هذا الخيار مخصّص للتوصيل داخل المتجر فقط.

LocalCutoffTime

الوقت الذي تنتهي فيه خدمة التسليم داخل المتجر لهذا اليوم.

الحقول
hour

int64

يجب تقديم طلبات التسليم في اليوم نفسه قبل ساعة واحدة من الموعد النهائي لمعالجتها في اليوم نفسه.
minute

int64

يجب تقديم طلبات التسليم في اليوم نفسه قبل مدة زمنية محددة لمعالجتها في اليوم نفسه.

StoreServiceType

تشير إلى ما إذا كانت جميع المتاجر أو متاجر محدّدة يعرضها التاجر توفّر خدمة التوصيل داخل المتجر.

عمليات التعداد
STORE_SERVICE_TYPE_UNSPECIFIED لم يتم تحديد نوع خدمة المتجر.
ALL_STORES يشير إلى ما إذا كانت جميع المتاجر، الحالية والمستقبلية، التي يعرضها هذا التاجر توفّر خدمة التوصيل داخل المتجر.
SELECTED_STORES تشير إلى أنّ المتاجر المدرَجة في store_codes فقط هي المؤهَّلة للتوصيل داخل المتجر.

ShippingSettings

إعدادات الشحن في حساب التاجر

الحقول
name

string

المعرّف اسم المورد لإعدادات الشحن التنسيق: accounts/{account}/shippingSetting
services[]

Service

اختيارية: قائمة الخدمات للحساب المستهدَف
warehouses[]

Warehouse

اختيارية: قائمة بالمستودعات التي يمكن الإشارة إليها في services
etag

string

مطلوب. يُستخدَم هذا الحقل لتجنُّب مشكلة عدم التزامن. تأكَّد من أنّ بيانات إعدادات الشحن لم تتغيّر بين get call وinsert call. على المستخدم اتّباع الخطوات التالية:

  1. اضبط حقل etag على سلسلة فارغة لإنشاء إعدادات الشحن الأولية.

  2. بعد الإنشاء الأولي، يمكنك استدعاء طريقة get للحصول على علامة etag وبيانات إعدادات الشحن الحالية قبل استدعاء insert.

  3. عدِّل معلومات إعدادات الشحن المطلوبة.

  4. استخدِم طريقة الإدراج مع معلومات إعدادات الشحن المطلوبة باستخدام علامة eTag التي تم الحصول عليها من الخطوة 2.

  5. إذا تغيّرت بيانات إعدادات الشحن بين الخطوة 2 والخطوة 4 سيتعذّر إدراج الطلب لأنّ علامة الهامش تتغيّر في كل مرة تتغيّر فيها بيانات إعدادات الشحن. على المستخدم تكرار الخطوات من 2 إلى 4 باستخدام علامة etag الجديدة.

جدول

جدول يحدّد مجموعة الأسعار، عندما لا يكون single_value تعبيريًا بما يكفي

الحقول
rows[]

Row

مطلوب. قائمة الصفوف التي تشكّل الجدول يجب أن يكون طولها هو نفسه طول row_headers.
name

string

اسم الجدول. مطلوبة للجداول الفرعية، ويتم تجاهلها في الجدول الرئيسي.
row_headers

Headers

مطلوب. رؤوس صفوف الجدول
column_headers

Headers

رؤوس أعمدة الجدول اختياري: في حال عدم ضبطه، يحتوي الجدول على سمة واحدة فقط.

TermsOfService

تمثّل رسالة TermsOfService إصدارًا محدّدًا من بنود الخدمة التي يجب أن يقبلها التجّار للوصول إلى ميزات أو خدمات معيّنة (راجِع https://support.google.com/merchants/answer/160173).

هذه الرسالة مهمة لعملية الإعداد، إذ تضمن موافقة التجّار على الاتفاقيات القانونية اللازمة لاستخدام الخدمة. يمكن للتجّار استرداد أحدث بنود الخدمة لـ kind وregion معيّنين من خلال RetrieveLatestTermsOfService، والموافقة عليها على النحو المطلوب من خلال AcceptTermsOfService.

الحقول
name

string

المعرّف اسم المورد لنسخة بنود الخدمة. التنسيق: termsOfService/{version}
region_code

string

رمز المنطقة كما هو محدّد في CLDR يمكن أن يكون هذا البلد هو البلد الذي تنطبق فيه "بنود الخدمة" على وجه التحديد أو 001 عندما يمكن التوقيع على "بنود الخدمة" نفسها في أي بلد.TermsOfService يُرجى العِلم أنّه عند التوقيع على بنود خدمة سارية على مستوى العالم، لا نزال نتوقع توفير بلد معيّن (يجب أن يكون بلد النشاط التجاري للتاجر أو بلد المشاركة في البرنامج).
kind

TermsOfServiceKind

النوع الذي ينطبق عليه إصدار بنود الخدمة هذا
external

bool

ما إذا كان إصدار بنود الخدمة هذا خارجيًا لا يمكن الموافقة على نُسخ شروط الخدمة الخارجية إلا من خلال عمليات خارجية وليس من خلال التاجر مباشرةً من خلال واجهة المستخدم أو واجهة برمجة التطبيقات.
file_uri

string

عنوان URL لملف بنود الخدمة الذي يجب عرضه للمستخدمين الذين يوقعون على التطبيق.

TermsOfServiceAgreementState

يمثّل هذا المرجع حالة الاتفاقية لحساب معيّن ونوع بنود الخدمة. في ما يلي الحالة:

  • إذا قبل التاجر بنود الخدمة: سيتم ملء الحقل accepted، وإلا سيكون فارغًا.
  • إذا كان على التاجر توقيع بنود الخدمة: سيتم ملء الحقل مطلوب، وإلا سيكون فارغًا.

يُرجى العلم أنّه يمكن استخدام كل من مطلوب ومقبول. في هذه الحالة، سيتم ضبط تاريخ انتهاء صلاحية لبنود خدمة accepted في الحقل valid_until. يجب قبول بنود خدمة required قبل valid_until لكي يظلّ للحساب اتفاقية صالحة. عند قبول بنود خدمة جديدة، نتوقع من الجهات الخارجية عرض النص المرتبط باتفاقية بنود الخدمة المحدّدة (يتمّ إضافة عنوان URL للملف الذي يحتوي على النص في الرسالة المطلوبة أدناه باسم tos_file_uri). يتم القبول الفعلي لبنود الخدمة من خلال استدعاء accept في المرجع TermsOfService.

الحقول
name

string

المعرّف اسم المورد لنسخة بنود الخدمة. التنسيق: accounts/{account}/termsOfServiceAgreementState/{identifier} تنسيق المعرّف هو: {TermsOfServiceKind}-{country} على سبيل المثال، يمكن أن يكون المعرّف: MERCHANT_CENTER-US
region_code

string

رمز المنطقة كما هو محدّد في https://cldr.unicode.org/. هذا هو البلد الذي تنطبق عليه الحالة الحالية.
terms_of_service_kind

TermsOfServiceKind

نوع بنود الخدمة المرتبطة بالإصدار المحدّد
accepted

Accepted

بنود الخدمة المقبولة من هذا النوع وتلك المرتبطة بـ region_code
required

Required

بنود الخدمة المطلوبة

TermsOfServiceKind

نوع TermsOfService

عمليات التعداد
TERMS_OF_SERVICE_KIND_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
MERCHANT_CENTER طلب Merchant Center

TransitTable

جدول وقت النقل، عدد أيام العمل التي تستغرقها عملية النقل استنادًا إلى سمات الصف والعمود يمكن ضبط min_transit_days أو max_transit_days أو transit_time_table، ولكن ليس كليهما.

الحقول
postal_code_group_names[]

string

مطلوب. قائمة بأسماء المناطق Region.name . يمكن أن تكون القيمة الأخيرة "all other locations". مثال: ["zone 1", "zone 2", "all other locations"] يجب أن تتطابق مجموعات الرموز البريدية المُشار إليها مع بلد تسليم الخدمة.
transit_time_labels[]

string

مطلوب. قائمة بتصنيفات مدة النقل يمكن أن تكون القيمة الأخيرة "all other labels". مثال: ["food", "electronics", "all other labels"]
rows[]

TransitTimeRow

مطلوب. إذا كانت هناك مجموعة سمات واحدة فقط من postal_code_group_names أو transit_time_labels، تكون هناك صفوف متعددة تحتوي كلّ صف منها على قيمة واحدة لهذه السمة. إذا كانت هناك سمتان، يتطابق كل صف مع postal_code_group_names، والأعمدة (القيم) مع transit_time_labels.

TransitTimeRow

إذا كانت هناك مجموعة سمات واحدة فقط من postal_code_group_names أو transit_time_labels، تكون هناك صفوف متعددة تحتوي كلّ صف منها على قيمة واحدة لهذه السمة. إذا كانت هناك سمتان، يتطابق كل صف مع postal_code_group_names، والأعمدة (القيم) مع transit_time_labels.

الحقول
values[]

TransitTimeValue

مطلوب. نطاق وقت النقل (الحد الأدنى والحد الأقصى) بأيام العمل

TransitTimeValue

نطاق وقت النقل (الحد الأدنى والحد الأقصى) بأيام العمل

الحقول
min_transit_days

int32

الحد الأدنى لنطاق مدة النقل بأيام العمل يشير الرقم 0 إلى التوصيل في اليوم نفسه، ويشير الرقم 1 إلى التوصيل في اليوم التالي.
max_transit_days

int32

يجب أن تكون أكبر من أو تساوي min_transit_days.

UnclaimHomepageRequest

رسالة طلب لطريقة UnclaimHomepage

الحقول
name

string

مطلوب. اسم الصفحة الرئيسية المطلوب إلغاء المطالبة بها التنسيق: accounts/{account}/homepage

UpdateAccountRequest

رسالة طلب لطريقة UpdateAccount

الحقول
account

Account

مطلوب. النسخة الجديدة من الحساب.
update_mask

FieldMask

اختيارية: قائمة الحقول التي يتم تعديلها

تتوفّر الحقول التالية (في كلّ من snake_case وlowerCamelCase):

  • account_name
  • adult_content
  • language_code
  • time_zone

UpdateAutofeedSettingsRequest

رسالة طلب لطريقة UpdateAutofeedSettings

الحقول
autofeed_settings

AutofeedSettings

مطلوب. الإصدار الجديد من إعداد الخلاصة التلقائية
update_mask

FieldMask

مطلوب. قائمة الحقول التي يتم تعديلها

UpdateBusinessIdentityRequest

رسالة طلب لطريقة UpdateBusinessIdentity

الحقول
business_identity

BusinessIdentity

مطلوب. النسخة الجديدة من هوية النشاط التجاري
update_mask

FieldMask

اختيارية: قائمة الحقول التي يتم تعديلها

تتوفّر الحقول التالية (في كلّ من snake_case وlowerCamelCase):

  • black_owned
  • latino_owned
  • promotions_consent
  • small_business
  • veteran_owned
  • women_owned

UpdateBusinessInfoRequest

رسالة طلب لطريقة UpdateBusinessInfo

الحقول
business_info

BusinessInfo

مطلوب. النسخة الجديدة من معلومات النشاط التجاري
update_mask

FieldMask

اختيارية: قائمة الحقول التي يتم تعديلها

تتوفّر الحقول التالية (في كلّ من snake_case وlowerCamelCase):

  • address
  • customer_service
  • korean_business_registration_number

UpdateEmailPreferencesRequest

رسالة طلب لطريقة UpdateEmailPreferences

الحقول
email_preferences

EmailPreferences

مطلوب. إعدادات البريد الإلكتروني المفضّلة التي سيتم تعديلها
update_mask

FieldMask

مطلوب. قائمة الحقول التي يتم تعديلها

تتوفّر الحقول التالية (في كلّ من snake_case وlowerCamelCase):

  • news_and_tips

UpdateHomepageRequest

رسالة طلب لطريقة UpdateHomepage

الحقول
homepage

Homepage

مطلوب. الإصدار الجديد من الصفحة الرئيسية
update_mask

FieldMask

اختيارية: قائمة الحقول التي يتم تعديلها

تتوفّر الحقول التالية (في كلّ من snake_case وlowerCamelCase):

  • uri

UpdateRegionRequest

رسالة طلب لطريقة UpdateRegion

الحقول
region

Region

مطلوب. المنطقة المعدَّلة.
update_mask

FieldMask

اختيارية: قناع الحقل مفصول بفواصل يشير إلى الحقول التي سيتم تعديلها. مثال: "displayName,postalCodeArea.regionCode"

UpdateUserRequest

رسالة طلب لطريقة UpdateUser

الحقول
user

User

مطلوب. النسخة الجديدة من المستخدِم.

استخدِم me للإشارة إلى عنوان بريدك الإلكتروني، على سبيل المثال accounts/{account}/users/me.
update_mask

FieldMask

اختيارية: قائمة الحقول التي يتم تعديلها

تتوفّر الحقول التالية (في كلّ من snake_case وlowerCamelCase):

  • access_rights

المستخدم

تمثّل رسالة User مستخدمًا مرتبطًا بحساب على Merchant Center. ويُستخدَم هذا الإجراء لإدارة أذونات المستخدمين وحقوق الوصول داخل الحساب. لمزيد من المعلومات، يُرجى الاطّلاع على الأسئلة الشائعة حول المستخدمين ومستويات الوصول.

الحقول
name

string

المعرّف اسم مورد المستخدِم. التنسيق: accounts/{account}/user/{email}

استخدِم me للإشارة إلى عنوان بريدك الإلكتروني، على سبيل المثال accounts/{account}/users/me.
state

State

النتائج فقط. حالة المستخدم.
access_rights[]

AccessRight

اختيارية: أذونات الوصول التي يمتلكها المستخدم

الحالة

الحالات المحتملة للمستخدِم

عمليات التعداد
STATE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
PENDING المستخدم في انتظار التأكيد. في هذه الحالة، على المستخدم أولاً قبول الدعوة قبل تنفيذ إجراءات أخرى.
VERIFIED تم إثبات هوية المستخدم.

القيمة

القيمة الفردية لمجموعة الأسعار أو قيمة خلية جدول مجموعة الأسعار. يجب ضبط قيمة واحدة بالضبط من no_shipping أو flat_rate أو price_percentage أو carrier_rateName أو subtable_name.

الحقول
no_shipping

bool

إذا كانت القيمة true، لا يمكن شحن المنتج. يجب أن يكون صحيحًا عند ضبطه، ولا يمكن ضبطه إلا إذا لم يتم ضبط جميع الحقول الأخرى.
flat_rate

Price

تعرفة ثابتة لا يمكن ضبطه إلا إذا لم يتم ضبط جميع الحقول الأخرى.
price_percentage

string

نسبة مئوية من السعر يتم تمثيلها كعدد بالتنسيق العشري (على سبيل المثال، "5.4"). لا يمكن ضبطها إلا إذا لم يتم ضبط جميع الحقول الأخرى.
carrier_rate

string

اسم تعرفة شركة نقل تشير إلى تعرفة شركة نقل محدّدة في مجموعة الأسعار نفسها. لا يمكن ضبطه إلا إذا لم يتم ضبط جميع الحقول الأخرى.
subtable

string

اسم جدول فرعي لا يمكن ضبطها إلا في خلايا الجدول (على سبيل المثال، لا يمكن ضبطها لقيم فردية)، ولا يمكن ضبطها إلا إذا لم يتم ضبط جميع الحقول الأخرى.

مستودع

مستودع للتوصيل، يخزّن المخزون ويعالجه

الحقول
name

string

مطلوب. اسم المخزن يجب أن يكون فريدًا داخل الحساب.
shipping_address

Address

مطلوب. عنوان الشحن للمستودع
cutoff_time

WarehouseCutoffTime

مطلوب. آخر وقت في اليوم يمكن فيه قبول طلب وبدء معالجته. ستتم معالجة الطلبات اللاحقة في اليوم التالي. تستند المدة إلى الرمز البريدي للمستودع.
handling_days

int64

مطلوب. عدد الأيام التي يستغرقها هذا المستودع في تغليف السلعة وشحنها يتم ذلك على مستوى المستودع، ولكن يمكن إلغاء ذلك على مستوى العرض استنادًا إلى سمات السلعة.
business_day_config

BusinessDayConfig

أيام عمل المخزن في حال عدم ضبط هذه القيمة، سيتم ضبطها تلقائيًا على أيام العمل من الاثنين إلى الجمعة.

WarehouseBasedDeliveryTime

يشير ذلك إلى أنّه يجب احتساب مدة التسليم لكل مستودع (الموقع الجغرافي لمصدر الشحن) استنادًا إلى إعدادات شركة النقل المحدّدة. عند ضبط هذا الحقل، يجب عدم ضبط أي حقل آخر مرتبط بمدة النقل في delivery_time.

الحقول
carrier

string

مطلوب. مشغّل شبكة الجوّال، مثل "UPS" أو "Fedex" شركات الجوّال المتوافقة
carrier_service

string

مطلوب. خدمة شركة النقل، مثل "ground" أو "2 days" يجب أن يكون اسم الخدمة مُدرَجًا في قائمة eddSupportedServices.
warehouse

string

مطلوب. اسم المستودع يجب أن تتطابق هذه القيمة مع [warehouse][ShippingSetting.warehouses.name]

WarehouseCutoffTime

آخر وقت في اليوم يمكن فيه قبول الطلب وبدء معالجته. ستتم معالجة الطلبات اللاحقة في اليوم التالي. تستند المدة إلى الرمز البريدي للمستودع.

الحقول
hour

int32

مطلوب. ساعة الموعد النهائي الذي يجب تقديم الطلب قبله لتتم معالجته في اليوم نفسه من قِبل المستودع يستند الوقت إلى المنطقة الزمنية للمستودع.
minute

int32

مطلوب. دقيقة من الموعد النهائي الذي يجب تقديم الطلب قبله لتتم معالجته في اليوم نفسه من قِبل المخزن. تستند الدقائق إلى المنطقة الزمنية للمستودع.