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.

AccountTaxService

تدير بيانات إعدادات الضريبة على مستوى الحساب.

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

  • AccountTax
GetAccountTax

rpc GetAccountTax(GetAccountTaxRequest) returns (AccountTax)

لعرض قواعد الضرائب التي تتطابق مع شروط GetAccountTaxRequest

نطاقات الأذونات

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

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

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

rpc ListAccountTax(ListAccountTaxRequest) returns (ListAccountTaxResponse)

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

نطاقات الأذونات

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

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

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

rpc UpdateAccountTax(UpdateAccountTaxRequest) returns (AccountTax)

لتعديل إعدادات الضريبة في الحساب

نطاقات الأذونات

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

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

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

AccountsService

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

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

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

نطاقات الأذونات

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

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

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

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

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

نطاقات الأذونات

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

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

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

rpc GetAccount(GetAccountRequest) returns (Account)

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

نطاقات الأذونات

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

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

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

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

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

نطاقات الأذونات

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

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

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
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.
UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

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

نطاقات الأذونات

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

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

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

BusinessIdentityService

خدمة تتوافق مع واجهة برمجة تطبيقات business Identity.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

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

نطاقات الأذونات

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

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

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

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

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

نطاقات الأذونات

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

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

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

BusinessInfoService

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

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

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

نطاقات الأذونات

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

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

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

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

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

نطاقات الأذونات

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

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

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

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.
UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

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

ولن يتم تعديل الإعدادات المفضّلة التي لم يتم اختيارها بشكل صريح في قناع التحديث.

لا يمكن تعديل قيمة حالة التفعيل غير المؤكدة للتحديثات.

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

نطاقات الأذونات

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

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

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

HomepageService

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

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

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

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

نطاقات الأذونات

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

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

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

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

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

نطاقات الأذونات

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

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

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

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

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

نطاقات الأذونات

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

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

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

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

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

نطاقات الأذونات

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

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

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

OnlineReturnPolicyService

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

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

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

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

توفّر سياسة إرجاع حالية:

نطاقات الأذونات

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

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

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

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

تعرض جميع سياسات الإرجاع الحالية.

نطاقات الأذونات

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

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

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

ProgramsService

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

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

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

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

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

نطاقات الأذونات

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

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

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

rpc EnableProgram(EnableProgramRequest) returns (Program)

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

نطاقات الأذونات

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

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

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

rpc GetProgram(GetProgramRequest) returns (Program)

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

نطاقات الأذونات

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

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

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

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

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

نطاقات الأذونات

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

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

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

RegionsService

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

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

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

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

نطاقات الأذونات

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

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

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

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

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

نطاقات الأذونات

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

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

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

rpc GetRegion(GetRegionRequest) returns (Region)

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

نطاقات الأذونات

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

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

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

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

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

نطاقات الأذونات

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

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

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

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

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

نطاقات الأذونات

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

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

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

ShippingSettingsService

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

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

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

نطاقات الأذونات

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

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

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

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

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

نطاقات الأذونات

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

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

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

TermsOfServiceAgreementStateService

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

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

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

نطاقات الأذونات

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

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

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

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

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

نطاقات الأذونات

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

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

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

TermsOfServiceService

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

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

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

نطاقات الأذونات

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

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

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

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

لاسترداد TermsOfService المرتبط بالنسخة المقدَّمة.

نطاقات الأذونات

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

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

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

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

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

نطاقات الأذونات

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

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

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

UserService

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

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

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

نطاقات الأذونات

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

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

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

rpc DeleteUser(DeleteUserRequest) returns (Empty)

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

نطاقات الأذونات

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

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

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

rpc GetUser(GetUserRequest) returns (User)

يسترد مستخدم حساب Merchant Center.

نطاقات الأذونات

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

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

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

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

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

نطاقات الأذونات

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

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

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

rpc UpdateUser(UpdateUserRequest) returns (User)

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

نطاقات الأذونات

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

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

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

AcceptTermsOfServiceRequest

يمكنك طلب تلقّي رسالة بشأن الطريقة AcceptTermsOfService.

الحقول
name

string

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

string

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

string

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

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

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

الحقول
terms_of_service

string

termsOfService المقبولة
accepted_by

string

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

Date

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

AccessRight

حق الوصول

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

Account

حساب.

الحقول
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.

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 المشكلة هي اقتراح للتحسين.

AccountTax

إعدادات الضريبة في حساب التاجر. تتطلب جميع الطرق دور المشرف.

الحقول
name

string

المُعرّف. اسم إعداد الضريبة. التنسيق: "{account_tax.name=accounts/{account}}"
account

int64

النتائج فقط. رقم تعريف الحساب الذي تنتمي إليه إعدادات الضريبة في الحساب.
tax_rules[]

TaxRule

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

العنوان

عنوان شحن المخزن:

الحقول
street_address

string

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

string

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

string

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

string

مطلوبة. الرمز البريدي (على سبيل المثال "94043").
region_code

string

مطلوبة. رمز CLDR للبلد (على سبيل المثال "US").

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

جمع المعلومات ذات الصلة بنشاط تجاري

الحقول
name

string

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

PostalAddress

اختياريّ. تمثّل هذه السمة عنوان النشاط التجاري.
phone

PhoneNumber

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

PhoneVerificationState

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

CustomerService

اختياريّ. خدمة عملاء النشاط التجاري.

CarrierRate

قائمة بأسعار شركات النقل التي يمكن الإشارة إليها من خلال main_table أو single_value.

الحقول
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

CreateAndConfigureAccountRequest

يمكنك طلب تلقّي رسالة بشأن الطريقة CreateAndConfigureAccount.

الحقول
account

Account

مطلوبة. الحساب الذي سيتم إنشاؤه
users[]

CreateUserRequest

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

AddAccountService

اختياريّ. كجزء من عملية الإنشاء، سيتم إعداد خدمة حساب بين الحساب الذي سيتم إنشاؤه وحساب مقدّم الخدمة، في حال تحديده.
accept_terms_of_service

AcceptTermsOfService

اختياريّ. قبول بنود الخدمة فور إنشاء الحساب

AcceptTermsOfService

الإشارة إلى مرجع بنود الخدمة

الحقول
name

string

مطلوبة. اسم المورد لإصدار بنود الخدمة
region_code

string

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

AddAccountService

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

الحقول
حقل الاتحاد service_type. يمكن حاليًا استخدام نوع الحساب الرئيسي متعدد العملاء فقط. يمكن أن يكون service_type واحدًا فقط مما يلي:
account_aggregation

Empty

موفِّر الهوية هو مجمّع سلع للحساب.
provider

string

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

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

اختياريّ. معرّف الموارد المنتظم (URI) الذي يمكن العثور على خدمة العملاء فيه
email

string

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

PhoneNumber

اختياريّ. تمثّل هذه السمة رقم الهاتف الذي قد يتم الاتصال بخدمة العملاء عليه.

CutoffTime

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

الحقول
hour

int32

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

int32

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

string

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

DeleteAccountRequest

يمكنك طلب تلقّي رسالة بشأن الطريقة DeleteAccount.

الحقول
name

string

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

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

اختياريّ. تشير هذه السمة إلى أنّه يجب احتساب مدة التسليم لكل مستودع (موقع مصدر الشحن) استنادًا إلى إعدادات شركة النقل المحدّدة. عند ضبط هذه السياسة، ما مِن حقل آخر مرتبط بمدة النقل في [مدة التسليم][[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 يعني أن يتم الشحن في اليوم التالي.
max_handling_days

int32

الحدّ الأقصى لعدد أيام العمل التي يمكن قضاؤها قبل شحن الطلب. 0 تعني أن يتم الشحن في اليوم نفسه، و 1 يعني أن يتم الشحن في اليوم التالي. يجب أن تكون القيمة أكبر من أو تساوي min_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}

GetAccountTaxRequest

طلب الحصول على إعدادات الضريبة

الحقول
name

string

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

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}

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

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

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

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

الحقول
name

string

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

bool

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

string

مطلوبة. تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بالصفحة الرئيسية للمتجر.

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

TimeZone

اختياريّ. تشير هذه السمة إلى المنطقة الزمنية IANA (المنظمة المعنية بأرقام الإنترنت المخصصة) والمستخدَمة لترجمة الأوقات في الحقول التي يمكن للإنسان قراءتها. على سبيل المثال، "America/Los_Angeles". وفي حال ترك هذه السياسة بدون ضبط، سيتم استخدام "America/Los_Angeles".

ListAccountIssuesResponse

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

الحقول
account_issues[]

AccountIssue

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

string

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

ListAccountTaxRequest

يجب طلب إدراج كل إعدادات الضريبة في الحساب الفرعي للتاجر الذي يقدّم الطلب فقط.

الحقول
parent

string

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

int32

الحد الأقصى لعدد إعدادات الضريبة المطلوب عرضها في الرد، ويتم استخدامه لنقل البيانات
page_token

string

الرمز المميّز الذي تم عرضه من خلال الطلب السابق

ListAccountTaxResponse

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

الحقول
account_taxes[]

AccountTax

صفحة إعدادات accounttax
next_page_token

string

الرمز المميز لاسترداد الصفحة التالية من إعدادات الضريبة في الحساب.

ListAccountsRequest

يمكنك طلب تلقّي رسالة بشأن الطريقة ListAccounts.

الحقول
page_size

int32

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

string

اختياريّ. رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "ListAccounts". ويمكنك توفير هذا الحقل لاسترداد الصفحة التالية.

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

string

اختياريّ. فلتر اختياري لعرض الحسابات التي تتطابق مع الفلتر فقط.

في ما يلي بعض الأمثلة على الفلاتر الصالحة:

  • accountName = "*store*" AND relationship(providerId = 123)
  • relationship(providerId = 123 AND service(type = "ACCOUNT_AGGREGATION"))
  • (accountName = "storeA") OR (accountName = "storeB")
  • relationship(service( handshakeState = "APPROVED" AND type = "ACCOUNT_MANAGEMENT"))
  • relationship(callerHasAccessToProvider() AND externalAccountId = "extAcctId" AND accountIdAlias = "alias")
  • (relationship(service(type = "ACCOUNT_MANAGEMENT") AND service(handshakeState = "PENDING"))) OR (accountName = "store" AND relationship(...))

تحتوي الفلاتر على مستوى الحساب على الدلالات التالية:

  • accountName يشير هذا الحقل إلى الحقل accountName في الحساب.
  • relationship(...) يشير هذا إلى علاقة بين الحساب وحساب آخر. يمكن تحديد هذه العلاقة بشكل أكبر ضمن الدالة.

تحتوي الفلاتر على مستوى العلاقة على الدلالات التالية:

  • providerId يشير هذا إلى المعرّف الرقمي للحساب المشترك الآخر في العلاقة. على سبيل المثال، إذا كان يجب أن يقتصر الفلتر على الحسابات التي ترتبط بالحساب accounts/name/123، يجب فلترة providerId على أنّها providerId = 123.
  • callerHasAccessToProvider() سيؤدي هذا الإجراء إلى حصر الحسابات الناتجة على هذه الحسابات التي لها علاقة بحساب آخر يمكن للمستخدم الذي يتصل به الوصول أيضًا إلى الطرف الآخر من العلاقة (أو مقدِّم الخدمة).
  • externalAccountId يشير ذلك إلى رقم تعريف الحساب الخارجي الذي تم إعداده للعلاقة.
  • accountIdAlias يشير ذلك إلى العنوان البديل للبريد الإلكتروني لرقم تعريف الحساب الذي تم إعداده للعلاقة.
  • service(...) يشير هذا المصطلح إلى خدمة يتم تقديمها كجزء من العلاقة. ملاحظة: يمكن أن تشتمل العلاقة بين حسابين على خدمات متعددة.

تحتوي الفلاتر على مستوى الخدمة على الدلالات التالية:

  • handshakeState يشير هذا إلى حالة تأكيد الاتصال للخدمة. عند إنشاء خدمة، تحتاج في بعض الأحيان إلى الموافقة عليها أولاً من قبل الطرف الآخر أو كليهما. وبالتالي، يمكن أن تكون حالة الخدمة PENDING أو APPROVED.
  • type يشير هذا الحقل إلى نوع الخدمة. القيم المتاحة:
    • ACCOUNT_MANAGEMENT يدير مقدّم الخدمة الحساب.
    • ACCOUNT_AGGREGATION مقدّم الخدمة هو مجمّع سلع للحساب.

يتّبع الفلتر مجموعة فرعية من مواصفات فلتر AIP وقواعد EBNF الرسمية الخاصة به، علمًا بأنّ القواعد النحوية لهذا الفلتر أكثر تقييدًا وتحديدًا.

filter
    : accountFilterDisj
    | accountFilterConj
    ;
accountFilterDisj
    : "(" accountFilterConj " OR " accountFilterConj ")"
    ;
accountFilterConj
    : accountFilter {" AND " accountFilter}
    ;
accountFilter
    : accountNameFilter | relationshipFn
    ;
accountNameFilter
    : "accountName" comparator value
    ;
relationshipFn
    : "relationship(" relationshipConj ")"
    ;
relationshipConj
    : relationshipFilter {" AND " relationshipFilter}
    ;
relationshipFilter
    : "providerId = " numValue
    | "callerHasAccessToProvider()"
    | "externalAccountId" comparator value
    | "accountIdAlias" comparator value
    | serviceFn
    ;
serviceFn
    : "service(" serviceConj ")"
    ;
serviceConj
    : serviceFilter {" AND " serviceFilter}
    ;
serviceFilter
    : handshakeStateFilter
    | typeFilter
    ;
handshakeStateFilter
    : "handshakeState = " value
    ;
typeFilter
    : "type = " value
    ;
comparator
    : " = " | " != "
    ;

بالإضافة إلى ذلك، ينطبق ما يلي:

  • قد يظهر كل حقل مرتبط بعلامتَي اقتباس مرة واحدة فقط (على سبيل المثال، لا يمكن الفلترة على accountName سوى مرة واحدة على مستوى الحساب، أو لا يمكن الفلترة للوصول إلى providerId سوى مرة واحدة على كل مستوى علاقة).
  • بالنسبة إلى حقول السلسلة (مثل accountName أو accountIdAlias)، يمكن التعبير عن عامل التشغيل CONTAINS من خلال تضمين طلب البحث في *. على سبيل المثال، ستعرض الدالة accountName = "*foo*" جميع الحسابات التي تتضمّن accountName تحتوي على foo. يمكن بشكل تسلسلي التعبير عن عامل تشغيل NOT_CONTAINS باستخدام !=. على سبيل المثال، ستعرض accountName != "*foo*" جميع الحسابات التي تحتوي على accountName ولا يحتوي على foo. ملاحظة: يمكن البحث عن حسابات ذات accountName تشتمل على رمز النجمة * باستخدام ***.
  • ويتم تجاهل المسافات البيضاء الإضافية.
  • يجب وضع جميع القيم بين علامات اقتباس مزدوجة باستثناء القيم العددية فقط.
  • في حال استخدام طريقة فصل، يجب أن تستخدم حروف العطف في كل جانب الأقواس حتى إذا كانت حرف العطف لها تعبير واحد فقط. لا يُسمح باستخدام الأقواس في أي مكان آخر باستثناء استدعاء الدوال (مثل relationship أو service). وذلك للتعبير بوضوح عن أنّ حروف العطف تكون أقوى من الانفصال المنطقي.

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)، يتم استخدام الحجم التلقائي وهو 1,000. الحد الأقصى للقيمة هي 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

مطلوبة. الحساب الرئيسي تنسيق الملف: accounts/{account}
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). يجب توفير مجموعتَين على الأقل، ويجب أن تكون المجموعة الأخيرة فارغة، ما يشير إلى "كيفية طلب البحث (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

سياسة الإرجاع.
restocking_fee

RestockingFee

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

ReturnMethod

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

ItemCondition

يجب ألا تكون شروط السلع المقبولة لإرجاع السلع فارغة إلّا إذا كان نوع سياسة الإرجاع هو "noReturns".
return_shipping_fee

ReturnShippingFee

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

string

تمثّل هذه السمة معرّف الموارد المنتظم (URI) لسياسة الإرجاع. ويمكن أن تستخدم 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 وسيدفع العملاء رسوم شحن المرتجعات الفعلية.

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* يشير إلى الحد الأعلى الشامل للنطاق الذي يحدّد المنطقة. يجب أن يكون طوله متطابق تمامًا مثلpostCodeRangeges: إذا كان postCodeRangeStart رمزًا بريديًا، فيجب أن يكون mailCodeRangeEnd رمزًا بريديًا أيضًا. وإذا كان postCodeRangeges هو نمط، يجب أن يكون mailCodeRangeEnd نمطًا له طول البادئة نفسه. اختياري: في حال عدم ضبط هذه السياسة، يتم تحديد المنطقة على أنّها جميع الرموز البريدية التي تتطابق مع mailCodeRangeStart.

مطلوبة

تصف الخدمة بنود الخدمة المطلوب قبولها

الحقول
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 للجداول الثنائية الأبعاد.

الخدمة

خدمة الشحن.

الحقول
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

MinimumOrderValueTable

جدول يبيّن الحد الأدنى لقيم طلبات الشراء حسب المتجر لنوع طريقة استلام الطلب لا يمكن ضبطها مع الحدّ الأدنى_ترتيب_القيمة.
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

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

LocalCutoffTime

الوقت الذي ينتهي فيه التسليم المحلي لليوم.

الحقول
hour

int64

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

int64

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

StoreServiceType

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

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

ShippingSettings

[إعدادات الشحن](https://support.google.com/merchants/answer/6069284) في حساب التاجر

الحقول
name

string

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

Service

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

Warehouse

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

string

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

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

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

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

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

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

جدول

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

الحقول
rows[]

Row

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

string

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

Headers

مطلوبة. عناوين صفوف الجدول.
column_headers

Headers

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

TaxRule

نوع المحادثة الأساسي

النسبة المئوية الصغيرة : لا يمكن أن تكون نسبة 100% = 1 000 000 و1% = 10 000 سالبة.

معلومات حول الوجود الضريبي والمَعلمات ذات الصلة التي تنطبق على الطلبات التي يتمّ تسليمها إلى المنطقة التي يغطيها مشرف ضرائب واحد. يتم إنشاء Nexus عندما يزاول تاجر نشاطًا تجاريًا في منطقة يديرها مشرف الضرائب (لا تتوفر إعدادات الربط الضريبي في الولايات الأمريكية إلا في الولايات الأمريكية). إذا كان التاجر لديه رابطة في ولاية أمريكية، عليه دفع الضرائب لجميع السلطات الضريبية المرتبطة بوجهة الشحن. رقم التعريف التالي : 8

الحقول
region_code

string

رمز المنطقة التي تسري فيها هذه القاعدة
shipping_taxed

bool

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

Interval

مطلوبة. الفترة الزمنية التي تصبح فيها هذه القاعدة سارية. إذا كانت المدة غير موجودة في effective_time المدرج، فحينئذ يكون مفتوحًا للمستقبل. تكون بداية هذه الفترة الزمنية شاملة، والنهاية حصرية.
حقل الاتحاد location. يُرجى وصف الموقع الجغرافي من خلال نطاق الرمز البريدي أو رقم تعريف المعايير. يمكن أن يكون location واحدًا فقط مما يلي:
location_id

int64

تمثّل هذه السمة admin_id أو criteria_id للمنطقة التي تنطبق فيها هذه القاعدة.
post_code_range

TaxPostalCodeRange

نطاق الرموز البريدية الذي تسري فيه هذه القاعدة.
حقل الاتحاد rate_calculation. ما هي طريقة احتساب معدّل الضريبة لعمليات التسليم إلى منطقة المشرف؟ ولا يمكن ضبطها إلا في الولايات الأمريكية. يمكن أن يكون rate_calculation واحدًا فقط مما يلي:
use_google_rate

bool

يعتمد السعر على الموقع الجغرافي للتسليم: إذا كان التاجر لديه رابطة في الولاية الأمريكية المعنية، تُضاف الأسعار من السلطات ذات نطاق السلطة على منطقة التسليم.
self_specified_rate_micros

int64

معدل ثابت محدد بالمايكرو، حيث تكون 100% = 1_000_000. هذه السمة مناسبة للولايات التي تفرض الضرائب بالاستناد إلى المصدر.

TaxPostalCodeRange

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

الحقول
start

string

مطلوبة. بداية نطاق الرمز البريدي، وهو أيضًا الأصغر في النطاق
end

string

نهاية نطاق الرمز البريدي. ستكون مماثلة لنقاط البداية إذا لم يتم تحديدها.

TermsOfService

TermsOfService

الحقول
name

string

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

string

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

TermsOfServiceKind

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

bool

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

string

معرّف موارد منتظم (URI) لملف بنود الخدمة الذي يجب عرضه للمستخدمين الموقّعين.

TermsOfServiceAgreementState

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

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

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

الحقول
name

string

المُعرّف. اسم المورد لإصدار بنود الخدمة تنسيق الملف: accounts/{account}/termsOfServiceAgreementState/{identifier}
region_code

string

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

TermsOfServiceKind

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

Accepted

بنود الخدمة المقبولة من هذا النوع ولمنطقة_رمز_المنطقة المرتبطة
required

Required

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

TermsOfServiceKind

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

عمليات التعداد
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

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

UpdateAccountTaxRequest

طلب تعديل إعدادات الضريبة

الحقول
account_tax

AccountTax

مطلوبة. إعداد الضريبة الذي سيتم تعديله
update_mask

FieldMask

قائمة الحقول التي سيتم تعديلها

UpdateBusinessIdentityRequest

يمكنك طلب تلقّي رسالة بشأن الطريقة UpdateBusinessIdentity.

الحقول
business_identity

BusinessIdentity

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

FieldMask

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

UpdateBusinessInfoRequest

يمكنك طلب تلقّي رسالة بشأن الطريقة UpdateBusinessInfo.

الحقول
business_info

BusinessInfo

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

FieldMask

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

UpdateEmailPreferencesRequest

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

الحقول
email_preferences

EmailPreferences

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

FieldMask

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

UpdateHomepageRequest

يمكنك طلب تلقّي رسالة بشأن الطريقة UpdateHomepage.

الحقول
homepage

Homepage

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

FieldMask

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

UpdateRegionRequest

يمكنك طلب تلقّي رسالة بشأن الطريقة UpdateRegion.

الحقول
region

Region

مطلوبة. المنطقة التي تم تعديلها.
update_mask

FieldMask

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

UpdateUserRequest

يمكنك طلب تلقّي رسالة بشأن الطريقة UpdateUser.

الحقول
user

User

مطلوبة. الإصدار الجديد للمستخدم.

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

FieldMask

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

المستخدِم

مستخدم:

الحقول
name

string

المُعرّف. اسم المورد للمستخدم. تنسيق الملف: accounts/{account}/user/{user}
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

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

مستودع

هو مستودع لتوصيل الطلبات، يخزِّن ويتعامل مع المستودع. العلامة التالية: 7

الحقول
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

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