Package google.shopping.merchant.accounts.v1beta

شاخص

AccountIssueService

سرویس برای پشتیبانی از AccountIssueService API.

ListAccountIssues

rpc ListAccountIssues( ListAccountIssuesRequest ) returns ( ListAccountIssuesResponse )

همه مشکلات حساب یک حساب Merchant Center را فهرست می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

خدمات حسابداری

سرویس پشتیبانی از Accounts API.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount( CreateAndConfigureAccountRequest ) returns ( Account )

یک حساب Merchant Center مستقل با پیکربندی اضافی ایجاد می کند. کاربری را که درخواست می کند به عنوان مدیر حساب جدید اضافه می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

حذف اکانت

rpc DeleteAccount( DeleteAccountRequest ) returns ( Empty )

حساب مشخص شده را بدون توجه به نوع آن حذف می کند: مستقل، MCA یا حساب فرعی. حذف یک MCA منجر به حذف تمام حساب های فرعی آن می شود. اجرای این روش نیاز به دسترسی ادمین دارد. حذف فقط در صورتی انجام می شود که حساب به هیچ حساب دیگری خدمات ارائه نکند و هیچ پیشنهاد پردازش شده ای نداشته باشد. شما می توانید از پارامتر force برای لغو آن استفاده کنید.

محدوده مجوز

به محدوده 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 نیست، بلکه همه حساب‌هایی که کاربر تماس‌گیرنده به آن‌ها دسترسی دارد شامل سایر 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 )

یک حساب را صرف نظر از نوع آن به روز می کند: مستقل، MCA یا حساب فرعی. اجرای این روش نیاز به دسترسی ادمین دارد.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

AutofeedSettingsService

سرویسی برای پشتیبانی از تنظیمات فید خودکار .

GetAutofeedSettings

rpc GetAutofeedSettings( GetAutofeedSettingsRequest ) returns ( AutofeedSettings )

تنظیمات فید خودکار یک حساب را بازیابی می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

UpdateAutofeedSettings

rpc UpdateAutofeedSettings( UpdateAutofeedSettingsRequest ) returns ( AutofeedSettings )

تنظیمات فید خودکار یک حساب را به روز می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

BusinessIdentityService

سرویس پشتیبانی از API هویت کسب و کار .

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

سرویس برای پشتیبانی API اطلاعات کسب و کار.

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

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 به روز می کند. کاربران MCA باید حساب MCA را به جای یک حساب فرعی MCA مشخص کنند.

تنظیمات برگزیده ای که به صراحت در ماسک به روز رسانی انتخاب نشده اند به روز نمی شوند.

برای به‌روزرسانی‌ها برای تعیین یک مقدار وضعیت انتخابی تأیید نشده نامعتبر است.

از نام مستعار name=accounts/*/users/me/emailPreferences برای به‌روزرسانی تنظیمات برگزیده برای کاربر تأیید شده استفاده کنید.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

خدمات صفحه اصلی

سرویس پشتیبانی از API برای صفحه اصلی فروشگاه.

ClaimHomepage

rpc ClaimHomepage( ClaimHomepageRequest ) returns ( Homepage )

صفحه اصلی فروشگاه را ادعا می کند. اجرای این روش نیاز به دسترسی ادمین دارد.

اگر صفحه اصلی قبلاً ادعا شده باشد، این تأیید مجدداً بررسی می‌شود (مگر اینکه تاجر از ادعا مستثنی باشد، که از تأیید نیز معاف است) و پاسخ موفقیت‌آمیز را برمی‌گرداند. اگر دیگر نتوان مالکیت را تأیید کرد، خطایی را برمی‌گرداند، اما ادعا را پاک نمی‌کند. در صورت خرابی، یک پیغام خطای متعارف برگردانده می شود: * PERMISSION_DENIED: کاربر مجوزهای لازم را در این حساب MC ندارد. * FAILED_PRECONDITION: - حساب یک حساب Merchant Center نیست. - حساب MC صفحه اصلی ندارد. - ادعا ناموفق بود (در این صورت پیام خطا حاوی جزئیات بیشتری خواهد بود).

محدوده مجوز

به محدوده 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 مراجعه کنید.

لغو ادعای صفحه اصلی

rpc UnclaimHomepage( UnclaimHomepageRequest ) returns ( Homepage )

صفحه اصلی فروشگاه را لغو می کند. اجرای این روش نیاز به دسترسی ادمین دارد.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

به روز رسانی صفحه اصلی

rpc UpdateHomepage( UpdateHomepageRequest ) returns ( Homepage )

صفحه اصلی فروشگاه را به روز می کند. اجرای این روش نیاز به دسترسی ادمین دارد.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

OnlineReturnPolicyService

این سرویس مدیریت پیکربندی سیاست بازگشت پشیمانی تاجر را تسهیل می‌کند، که شامل سیاست‌های بازگشت هم برای تبلیغات و هم برای فهرست‌های رایگان می‌شود.

برنامه ها این API مدل منبع زیر را تعریف می کند:

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

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy( GetOnlineReturnPolicyRequest ) returns ( OnlineReturnPolicy )

یک سیاست بازگشت موجود را دریافت می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ListOnlineReturn Policies

rpc ListOnlineReturnPolicies( ListOnlineReturnPoliciesRequest ) returns ( ListOnlineReturnPoliciesResponse )

تمام سیاست های بازگشت موجود را فهرست می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

برنامه های سرویس

سرویس برای مدیریت برنامه

برنامه ها مکانیزمی را برای افزودن عملکرد به حساب های تجاری ارائه می دهند. یک مثال معمولی از این برنامه، برنامه فهرست‌بندی محصولات رایگان است که محصولات فروشگاه تاجر را قادر می‌سازد به صورت رایگان در سراسر Google نشان داده شوند.

این سرویس روش‌هایی را برای بازیابی مشارکت تاجر در همه برنامه‌های موجود، به‌علاوه روش‌هایی برای فعال کردن یا غیرفعال کردن صریح مشارکت در هر برنامه نشان می‌دهد.

غیرفعال کردن برنامه

rpc DisableProgram( DisableProgramRequest ) returns ( Program )

غیرفعال کردن مشارکت در برنامه مشخص شده برای حساب. اجرای این روش نیاز به دسترسی ادمین دارد.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

فعال کردن برنامه

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 مراجعه کنید.

لیست برنامه ها

rpc ListPrograms( ListProgramsRequest ) returns ( ListProgramsResponse )

همه برنامه ها را برای حساب بازیابی می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

منطقه خدمات

پیکربندی مناطق را مدیریت می کند.

این API مدل منبع زیر را تعریف می کند:

  • Region
ایجاد منطقه

rpc CreateRegion( CreateRegionRequest ) returns ( Region )

یک تعریف منطقه در حساب Merchant Center شما ایجاد می کند. اجرای این روش نیاز به دسترسی ادمین دارد.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

منطقه را حذف کنید

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 مراجعه کنید.

فهرست مناطق

rpc ListRegions( ListRegionsRequest ) returns ( ListRegionsResponse )

مناطق را در حساب Merchant Center شما فهرست می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

به روز رسانی منطقه

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

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

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 مراجعه کنید.

سرویس کاربر

سرویس برای پشتیبانی از API کاربر.

CreateUser

rpc CreateUser( CreateUserRequest ) returns ( User )

یک کاربر حساب Merchant Center ایجاد می کند. اجرای این روش نیاز به دسترسی ادمین دارد.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

حذف کاربر

rpc DeleteUser( DeleteUserRequest ) returns ( Empty )

یک کاربر حساب Merchant Center را حذف می کند. اجرای این روش نیاز به دسترسی ادمین دارد. کاربری که باید حذف شود نمی تواند آخرین کاربر سرپرست آن حساب باشد. همچنین اگر کاربر توسط Business Manager مدیریت شود از حذف محافظت می شود.

محدوده مجوز

به محدوده 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 مراجعه کنید.

لیست کاربران

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

مورد نیاز. حسابی که ToS برای آن می‌پذیرد.

region_ code

string

مورد نیاز. کد منطقه ای که توسط CLDR تعریف شده است. این کشور زمانی است که ToS به طور خاص برای آن کشور اعمال می شود یا 001 زمانی که در سطح جهانی اعمال می شود.

پذیرفته شد

شرایط خدمات پذیرفته شده را شرح می دهد.

فیلدها
terms_ of_ service

string

شرایط پذیرفته شدهOfService .

accepted_ by

string

حسابی که پذیرش در آن ثبت شده است. این می تواند خود حساب یا در مورد حساب های فرعی، حساب MCA باشد.

valid_ until

Date

هنگام تنظیم، بیان می کند که TermsOfService پذیرفته شده فقط تا پایان این تاریخ (به UTC) معتبر است. قبل از آن باید یک مورد جدید پذیرفته شود. اطلاعات TermsOfService مورد نیاز در پیام Required یافت می شود.

AccessRight

حق دسترسی

Enums
ACCESS_RIGHT_UNSPECIFIED مقدار پیش فرض این مقدار استفاده نشده است.
STANDARD حقوق دسترسی استاندارد
ADMIN حقوق دسترسی ادمین
PERFORMANCE_REPORTING کاربران دارای این حق به عملکرد و بینش دسترسی دارند.

حساب

یک حساب کاربری

فیلدها
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 .

Account Issue

یک AccountIssue

فیلدها
name

string

شناسه. نام منبع مشکل حساب. قالب: accounts/{account}/issues/{id}

title

string

عنوان بومی شده موضوع.

severity

Severity

شدت کلی موضوع.

impacted_ destinations[]

ImpactedDestination

تاثیر این موضوع بر مقاصد مختلف.

detail

string

جزئیات محلی بیشتر در مورد این موضوع.

documentation_ uri

string

پیوند به مرکز راهنمایی Merchant Center که اطلاعات بیشتری در مورد مشکل و نحوه رفع آن ارائه می دهد.

Impacted Destination

تاثیر موضوع بر یک مقصد.

فیلدها
impacts[]

Impact

تأثیر (منفی) برای مناطق مختلف در مقصد معین.

reporting_ context

ReportingContextEnum

بافت گزارش تحت تاثیر

تاثیر

تاثیر موضوع بر یک منطقه

فیلدها
region_ code

string

کد منطقه CLDR که در آن این مشکل اعمال می شود.

severity

Severity

شدت موضوع در مقصد و منطقه.

شدت

تمام شدت مسائل ممکن

Enums
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").

تنظیمات تغذیه خودکار

مجموعه ای از اطلاعات مربوط به تنظیمات تغذیه خودکار .

فیلدها
name

string

شناسه. نام منبع تنظیمات فید خودکار. قالب: accounts/{account}/autofeedSettings .

enable_ products

bool

مورد نیاز. خزیدن محصول از طریق فید خودکار برای حساب داده شده را فعال یا غیرفعال می کند. حساب‌های فید خودکار باید شرایط خاصی را داشته باشند که می‌توان آن‌ها را از طریق فیلد eligible بررسی کرد. حساب نباید یک بازار باشد. وقتی تغذیه خودکار برای اولین بار فعال می شود، محصولات معمولاً فوراً ظاهر می شوند. هنگام فعال کردن مجدد، ممکن است تا 24 ساعت طول بکشد تا محصولات ظاهر شوند.

eligible

bool

فقط خروجی تعیین می کند که آیا تاجر برای ثبت نام در فید خودکار واجد شرایط است یا خیر.

BusinessDayConfig

روزهای کاری انبار.

فیلدها
business_ days[]

Weekday

مورد نیاز. روزهای کاری منظم ممکنه خالی نباشه

روز هفته

Enums
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

هویت تجاری

جمع آوری اطلاعات مربوط به هویت یک کسب و کار .

فیلدها
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

مورد نیاز. اعلام هویت برای این ویژگی.

اعلام هویت

تمام تنظیمات ممکن در مورد اعلام هویت.

Enums
IDENTITY_DECLARATION_UNSPECIFIED مقدار پیش فرض نشان می دهد که هیچ انتخابی انجام نشده است.
SELF_IDENTIFIES_AS نشان می دهد که حساب با ویژگی مشخص می شود.
DOES_NOT_SELF_IDENTIFY_AS نشان می دهد که حساب با این ویژگی یکسان نیست.

ترفیعات رضایت

تمام تنظیمات ممکن در مورد تبلیغات مرتبط با هویت کسب و کار.

Enums

BusinessInfo

جمع آوری اطلاعات مربوط به یک کسب و کار.

فیلدها
name

string

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

address

PostalAddress

اختیاری. آدرس کسب و کار.

phone

PhoneNumber

فقط خروجی شماره تلفن کسب و کار

phone_ verification_ state

PhoneVerificationState

فقط خروجی وضعیت تأیید تلفن کسب و کار.

customer_ service

CustomerService

اختیاری. خدمات مشتری کسب و کار.

korean_ business_ registration_ number

string

اختیاری. شماره 10 رقمی ثبت کسب و کار کره ای که با خط تیره در قالب: XXX-XX-XXXXXX از هم جدا شده است.

نرخ حامل

فهرستی از نرخ‌های شرکت مخابراتی که می‌توان با استفاده از 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" } $1 به نرخ اضافه می کند، { "amount_micros": -3, "currency_code" : "USD" } $3 را از نرخ حذف می کند.

ClaimHomepageRequest

درخواست پیام برای روش ClaimHomepage .

فیلدها
name

string

مورد نیاز. نام صفحه اصلی برای ادعا. قالب: accounts/{account}/homepage

overwrite

bool

اختیاری. وقتی روی true تنظیم شود، این گزینه هرگونه ادعای موجود در وب‌سایت درخواستی را حذف می‌کند و آن را با ادعایی از حسابی که درخواست می‌کند جایگزین می‌کند.

CreateAndConfigureAccountRequest

درخواست پیام برای متد CreateAndConfigureAccount .

فیلدها
account

Account

مورد نیاز. حسابی که باید ایجاد شود.

users[]

CreateUserRequest

اختیاری. کاربران به حساب اضافه شوند.

service[]

AddAccountService

مورد نیاز. یک سرویس حساب بین حسابی که باید ایجاد شود و حساب ارائه دهنده به عنوان بخشی از ایجاد مقداردهی اولیه می شود. حداقل یکی از این خدمات باید ارائه شود. در حال حاضر دقیقاً یکی از اینها باید account_aggregation باشد، به این معنی که از طریق این روش فقط می‌توانید حساب‌های فرعی ایجاد کنید، نه حساب مستقل. ممکن است خدمات account_management یا product_management اضافی ارائه شود.

AddAccountService

دستورالعمل های اضافی برای افزودن خدمات حساب در حین ایجاد حساب.

فیلدها
service_type میدانی اتحادیه. نوع سرویسی که باید اضافه شود. service_type تنها می تواند یکی از موارد زیر باشد:
account_ aggregation

AccountAggregation

ارائه دهنده یک جمع کننده برای حساب است. بار برای نوع خدمات تجمیع حساب.

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

مورد نیاز. کاربر برای ایجاد.

خدمات مشتری

اطلاعات خدمات مشتری

فیلدها
uri

string

اختیاری. URI که در آن خدمات مشتری ممکن است پیدا شود.

email

string

اختیاری. آدرس ایمیلی که ممکن است به خدمات مشتری دسترسی پیدا کند.

phone

PhoneNumber

اختیاری. شماره تلفنی که ممکن است با خدمات مشتری تماس گرفته شود.

Cutoff Time

تعریف زمان قطع روزهای کاری

فیلدها
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 کاربر مربوط به تماس‌گیرنده را حذف کنید.

زمان تحویل

زمان صرف شده در جنبه های مختلف از سفارش تا تحویل محصول.

فیلدها
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 به معنای ارسال روز بعد است. '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

روزهای کاری که طی آن سفارش‌ها می‌توانند در حال انتقال باشند. در صورت عدم ارائه، روزهای کاری دوشنبه تا جمعه در نظر گرفته می شود.

غیرفعال کردن برنامه Request

درخواست پیام برای متد DisableProgram.

فیلدها
name

string

مورد نیاز. نام برنامه ای که برای آن مشارکت برای حساب داده شده غیرفعال شود. قالب: accounts/{account}/programs/{program}

فاصله

حداکثر شعاع تحویل این فقط برای نوع حمل و نقل محلی مورد نیاز است.

فیلدها
value

int64

مقدار صحیح فاصله

unit

Unit

واحد می تواند بر اساس کشور متفاوت باشد، پارامتری است که شامل مایل ها و کیلومترها می شود.

واحد

واحد می تواند بر اساس کشور متفاوت باشد، پارامتری است که شامل مایل ها و کیلومترها می شود.

Enums
UNIT_UNSPECIFIED واحد نامشخص
MILES واحد بر حسب مایل
KILOMETERS واحد بر حسب کیلومتر

تنظیمات ایمیل

دسته‌های اعلان‌هایی که کاربر انتخاب کرده یا از آن‌ها انصراف داده است. اولویت‌های ایمیل شامل اعلامیه‌های اجباری نمی‌شوند، زیرا کاربران نمی‌توانند از آنها انصراف دهند.

فیلدها
name

string

شناسه. نام EmailPreferences. نقطه پایانی فقط برای کاربر تایید شده پشتیبانی می شود.

news_ and_ tips

OptInState

اختیاری. به روز رسانی در مورد ویژگی های جدید، نکات و بهترین شیوه ها.

OptInState

در حالت اولویت ایمیل انتخاب کنید.

Enums
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 postal_code_group_names num_items ، نام‌های_گروه_کد_پستی یا location باید تنظیم شود.

فیلدها
prices[]

Price

مورد نیاز. فهرستی از کرانه های بالای قیمت سفارش. مقدار آخرین قیمت می تواند بی نهایت باشد با تنظیم قیمت مقدار_micro = -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

مورد نیاز. فهرستی از کرانهای بالای وزن سفارش. مقدار آخرین وزن می تواند بی نهایت باشد با تنظیم قیمت مقدار_micro = -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 (معمولاً یک URL) صفحه اصلی فروشگاه.

InsertShippingSettingsRequest

درخواست پیام برای روش InsertShippingSetting .

فیلدها
parent

string

مورد نیاز. حسابی که این محصول در آن درج خواهد شد. قالب: حساب‌ها/{حساب}

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 قبلی دریافت شده است. این کار را برای بازیابی صفحه بعدی ارائه دهید.

پاسخ لیست

پیام پاسخ برای روش ListPrograms.

فیلدها
programs[]

Program

برنامه های مربوط به حساب داده شده.

next_ page_ token

string

نشانه ای که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت از بین برود ، هیچ صفحه بعدی وجود ندارد.

لاتین

پیام را برای روش ListRegions درخواست کنید.

فیلدها
parent

string

مورد نیاز. حساب برای لیست مناطق برای. قالب: accounts/{account}

page_ size

int32

اختیاری. حداکثر تعداد مناطق برای بازگشت. این سرویس ممکن است کمتر از این مقدار برگردد. در صورت نامشخص ، حداکثر 50 منطقه بازگردانده می شود. حداکثر مقدار 1000 است ؛ مقادیر بالاتر از 1000 به 1000 نفر اجبار می شود.

page_ token

string

اختیاری. یک صفحه صفحه ، که از تماس قبلی ListRegions دریافت شده است. این کار را برای بازیابی صفحه بعدی ارائه دهید.

هنگام پیگیری ، تمام پارامترهای دیگر که به ListRegions ارائه شده است باید با تماس ارائه شده در صفحه مطابقت داشته باشند.

پاسخ

پیام پاسخ برای روش 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 برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت از بین برود ، هیچ صفحه بعدی وجود ندارد.

لیست

درخواست پیام برای روش ListUsers .

فیلدها
parent

string

مورد نیاز. والدین ، ​​که صاحب این مجموعه از کاربران است. قالب: accounts/{account}

page_ size

int32

اختیاری. حداکثر تعداد کاربران برای بازگشت. این سرویس ممکن است کمتر از این مقدار برگردد. در صورت نامشخص ، حداکثر 50 کاربر بازگردانده می شوند. حداکثر مقدار 100 است. مقادیر بالاتر از 100 به 100

page_ token

string

اختیاری. یک صفحه صفحه ، که از تماس قبلی ListUsers دریافت می شود. این کار را برای بازیابی صفحه بعدی ارائه دهید.

در هنگام پیگیری ، تمام پارامترهای دیگر ارائه شده به ListUsers باید با تماس ارائه شده با صفحه مطابقت داشته باشند.

پاسخ لیست

پیام پاسخ برای روش ListUsers .

فیلدها
users[]

User

کاربران از حساب مشخص شده.

next_ page_ token

string

یک نشانه ، که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت از بین برود ، هیچ صفحه بعدی وجود ندارد.

محل سکونت

لیستی از مجموعه شناسه های مکان. باید غیر خالی باشد. فقط در صورت تنظیم همه زمینه های دیگر قابل تنظیم است.

فیلدها
location_ ids[]

string

مورد نیاز. لیست غیر خالی از شناسه های مکان . همه آنها باید از یک نوع مکان یکسان باشند (به عنوان مثال ، حالت).

حداقل

جدول حداقل مقادیر سفارش برای هر فروشگاه برای نوع تحقق وانت.

فیلدها
store_ code_ set_ with_ movs[]

StoreCodeSetWithMov

مورد نیاز. لیستی از کد فروشگاه به اشتراک می گذارد که حداقل مقدار سفارش (MOV) را به اشتراک می گذارد. حداقل دو مجموعه مورد نیاز است و آخرین مورد باید خالی باشد ، که نشانگر "حرکت برای همه فروشگاه های دیگر" است. هر کد فروشگاه فقط می تواند یک بار در تمام مجموعه ها ظاهر شود. تمام قیمت های موجود در یک سرویس باید همان ارز داشته باشند.

storecodesetwithmov

لیستی از کد فروشگاه به اشتراک گذاری با حداقل مقدار سفارش. حداقل دو مجموعه مورد نیاز است و آخرین مورد باید خالی باشد ، که نشانگر "حرکت برای همه فروشگاه های دیگر" است. هر کد فروشگاه فقط می تواند یک بار در تمام مجموعه ها ظاهر شود. تمام قیمت های موجود در یک سرویس باید همان ارز داشته باشند.

فیلدها
store_ codes[]

string

اختیاری. لیستی از کدهای فروشگاه منحصر به فرد یا خالی برای همه.

value

Price

حداقل مقدار سفارش برای فروشگاه های داده شده.

OnlineReturnPolicy

موضوع سیاست بازگشت آنلاین . این در حال حاضر برای نشان دادن سیاست های بازگشت برای تبلیغات و برنامه های لیست رایگان استفاده می شود.

فیلدها
name

string

شناسه. نام منبع OnlineReturnPolicy . قالب: accounts/{account}/onlineReturnPolicies/{return_policy}

return_ policy_ id

string

فقط خروجی شناسه خط مشی تولید شده توسط Google.

label

string

این قسمت نشان دهنده برچسب منحصر به فرد تعریف شده توسط کاربر از خط مشی بازگشت است. توجه به این نکته حائز اهمیت است که از همان برچسب در سیاست های مختلف بازگشت برای همان کشور قابل استفاده نیست. مگر اینکه یک محصول یک ویژگی برچسب خاص را مشخص کند ، خط مشی ها به طور خودکار به عنوان "پیش فرض" برچسب گذاری می شوند. برای اختصاص یک خط مشی بازگشت سفارشی به گروههای خاص ، دستورالعمل های ارائه شده در برچسب خط مشی بازگشت را دنبال کنید. این برچسب می تواند حداکثر 50 کاراکتر داشته باشد.

countries[]

string

کشورهای فروش که در آن سیاست بازگشت اعمال می شود. مقادیر باید یک کد معتبر 2 حرف ISO 3166 باشد.

policy

Policy

سیاست بازگشت

restocking_ fee

RestockingFee

هزینه بازپرداخت که در مورد همه دسته های عقل برگشتی اعمال می شود. در صورت عدم تعیین مقدار ، این امر به عنوان هزینه بازپرداخت رایگان رفتار می شود.

return_ methods[]

ReturnMethod

روش های بازگشت چگونه مشتریان می توانند یک مورد را برگردانند. این مقدار لازم است خالی نباشد مگر اینکه نوع خط مشی بازگشت نورتورن باشد.

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

این قسمت مشخص می کند که آیا بازرگان به مشتریان اجازه می دهد محصولات را تبادل کنند ، این زمینه مورد نیاز است.

مربوط به

شرایط موجود

Enums
ITEM_CONDITION_UNSPECIFIED مقدار پیش فرض این مقدار بلااستفاده است.
NEW جدید.
USED استفاده می شود.

سیاست

سیاست های موجود

فیلدها
type

Type

نوع سیاست.

days

int64

تعداد روزهای روز پس از زایمان قابل بازگشت است ، جایی که یک روز 24 ساعت پس از زمان بندی تحویل تعریف می شود. مورد نیاز برای NUMBER_OF_DAYS_AFTER_DELIVERY AFTER_DELIVERY است.

تایپ کنید

انواع خط مشی بازگشت.

Enums
TYPE_UNSPECIFIED مقدار پیش فرض این مقدار بلااستفاده است.
NUMBER_OF_DAYS_AFTER_DELIVERY تعداد روزهایی که بازده پس از تحویل معتبر است.
NO_RETURNS بدون بازگشت.
LIFETIME_RETURNS زمان زندگی برمی گردد.

RestockingFee

هزینه بازگرداندن این می تواند یک هزینه مسطح یا درصد خرد باشد.

فیلدها

type میدان اتحادیه.

type فقط می تواند یکی از موارد زیر باشد:

fixed_ fee

Price

هزینه بازپرداخت ثابت.

micro_ percent

int32

درصد کل قیمت در میکرو. 15،000،000 به معنای 15 ٪ از کل قیمت است.

بازگرداندن

روش های بازگشت موجود.

Enums
RETURN_METHOD_UNSPECIFIED مقدار پیش فرض این مقدار بلااستفاده است.
BY_MAIL بازگشت از طریق پست
IN_STORE بازگشت به فروشگاه.
AT_A_KIOSK بازگشت به یک کیوسک.

ReturnshippingFee

هزینه حمل و نقل بازگشت. این می تواند یک هزینه ثابت یا یک بولی باشد تا نشان دهد مشتری هزینه حمل و نقل واقعی را پرداخت می کند.

فیلدها
type

Type

نوع هزینه حمل و نقل بازگشت.

fixed_ fee

Price

مبلغ هزینه حمل و نقل برگشت ثابت. این مقدار فقط در صورت FIXED نوع قابل اجرا است. اگر نوع FIXED باشد و این مقدار تنظیم نشده باشد ، ما با هزینه حمل و نقل بازده به صورت رایگان رفتار خواهیم کرد.

تایپ کنید

انواع هزینه حمل و نقل را برگردانید.

Enums
TYPE_UNSPECIFIED مقدار پیش فرض این مقدار بلااستفاده است.
FIXED هزینه حمل و نقل بازگشت یک مقدار ثابت است.
CUSTOMER_PAYING_ACTUAL_FEE مشتریان هزینه واقعی حمل و نقل بازده را پرداخت می کنند.

تلفن

وضعیت تأیید تلفن

Enums
PHONE_VERIFICATION_STATE_UNSPECIFIED مقدار پیش فرض این مقدار بلااستفاده است.
PHONE_VERIFICATION_STATE_VERIFIED تلفن تأیید شده است.
PHONE_VERIFICATION_STATE_UNVERIFIED تلفن تأیید نشده است

برنامه

مشارکت در یک برنامه معین را برای حساب مشخص شده تعریف می کند.

برنامه ها مکانیسمی برای افزودن عملکرد به حسابهای بازرگان ارائه می دهند. نمونه بارز این برنامه لیست محصولات رایگان محصولات است که باعث می شود محصولاتی از فروشگاه یک بازرگان به صورت رایگان در Google نشان داده شود.

فیلدها
name

string

شناسه. نام منابع برنامه. قالب: accounts/{account}/programs/{program}

documentation_ uri

string

فقط خروجی URL صفحه راهنمای مرکز بازرگان که برنامه را توصیف می کند.

state

State

فقط خروجی وضعیت مشارکت حساب در برنامه.

active_ region_ codes[]

string

فقط خروجی مناطقی که حساب در آن به طور فعال در برنامه شرکت می کند. مناطق فعال به عنوان مناطقی تعریف می شوند که کلیه الزامات برنامه مؤثر بر مناطق برآورده شده است.

کدهای منطقه توسط CLDR تعریف شده است. این یا کشوری است که در آن برنامه به طور خاص در مورد آن کشور اعمال می شود یا 001 وقتی برنامه در سطح جهان اعمال می شود.

unmet_ requirements[]

Requirement

فقط خروجی الزاماتی که حساب هنوز راضی نشده است و بر مشارکت در برنامه تأثیر می گذارد.

مورد نیاز

الزام مشخص شده برای مشارکت در برنامه را تعریف می کند.

فیلدها
title

string

فقط خروجی نام شرط

documentation_ uri

string

فقط خروجی URL یک صفحه راهنما توصیف نیاز.

affected_ region_ codes[]

string

فقط خروجی مناطقی که در حال حاضر تحت تأثیر این شرط قرار نمی گیرند ، برآورده نمی شوند.

کدهای منطقه توسط CLDR تعریف شده است. این یا کشوری است که در آن برنامه به طور خاص در مورد آن کشور اعمال می شود یا 001 وقتی برنامه در سطح جهان اعمال می شود.

ایالت

مشارکت برنامه ممکن برای حساب.

Enums
STATE_UNSPECIFIED مقدار پیش فرض این مقدار بلااستفاده است.
NOT_ELIGIBLE حساب واجد شرایط شرکت در برنامه نیست.
ELIGIBLE حساب واجد شرایط شرکت در برنامه است.
ENABLED این برنامه برای حساب فعال شده است.

گروه

تعاریف گروه نرخ حمل و نقل. فقط آخرین مورد مجاز به داشتن یک خالی 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

اختیاری. نام نمایش منطقه.

ژئوتارجته

لیستی از ژئوتارجت ها که منطقه منطقه را تعریف می کند.

فیلدها
geotarget_ criteria_ ids[]

int64

مورد نیاز. لیست غیر خالی از شناسه های مکان . همه آنها باید از یک نوع مکان یکسان باشند (به عنوان مثال ، حالت).

عبادت

لیستی از کدهای پستی که منطقه منطقه را تعریف می کند. توجه: کلیه مناطق تعریف شده با استفاده از کدهای پستی از طریق منبع ShippingSettings.postalCodeGroups حساب کاربری قابل دسترسی هستند.

فیلدها
region_ code

string

مورد نیاز. کد قلمرو CLDR یا کشور گروه کد پستی برای آن اعمال می شود.

postal_ codes[]

PostalCodeRange

مورد نیاز. طیف وسیعی از کدهای پستی.

غیر عادی

طیف وسیعی از کدهای پستی که منطقه منطقه را تعریف می کند.

فیلدها
begin

string

مورد نیاز. یک کد پستی یا الگویی از پیشوند فرم* که نشانگر محدودیت پایین فراگیر محدوده منطقه است. مثالها مقادیر: 94108 ، 9410* ، 9* .

end

string

اختیاری. یک کد پستی یا الگویی از prefix* که نشانگر محدوده بالایی فراگیر دامنه است که منطقه را تعریف می کند. باید به همان طول PostalCoderAngeBegin داشته باشد: اگر PostalCoderAngeBegin یک کد پستی باشد ، postalcoderangeend نیز باید یک کد پستی باشد. اگر PostalCoderAngeBegin یک الگوی باشد ، postalcoderangeend باید الگویی با طول پیشوند باشد. اختیاری: اگر تنظیم نشده باشد ، منطقه به عنوان تمام کدهای پستی مطابق با postalcoderangebegin تعریف می شود.

مورد نیاز

شرایط خدماتی را که لازم است پذیرفته شود ، توصیف می کند.

فیلدها
terms_ of_ service

string

خدمات مربوط به خدمات که باید پذیرفته شوند.

tos_ file_ uri

string

URL کامل به شرایط پرونده خدمات. این قسمت همان اصطلاحات مربوط به سرویس است. file_uri ، فقط برای راحتی در اینجا اضافه می شود.

retriveforapplicationmsOfserviceAgreementSteRemeSostequest

پیام درخواست برای روش RetrieveForApplicationTermsOfServiceAgreementState .

فیلدها
parent

string

مورد نیاز. حساب کاربری برای دریافت فرمت OFServiceAgreementState: accounts/{account}

رتیولتست ترم

پیام درخواست برای روش RetrieveLatestTermsOfService .

فیلدها
region_ code

string

مورد نیاز. کد منطقه همانطور که توسط CLDR تعریف شده است. این یا کشوری است که TOS به طور خاص در مورد آن کشور یا 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

حداقل مقدار سفارش برای این سرویس. در صورت تنظیم ، نشان می دهد که مشتریان باید حداقل این مبلغ را خرج کنند. تمام قیمت های موجود در یک سرویس باید همان ارز داشته باشند. نمی توان همراه با حداقل_رد_Value_Table تنظیم کرد.

minimum_ order_ value_ table

MinimumOrderValueTable

جدول حداقل مقادیر سفارش برای هر فروشگاه برای نوع تحقق وانت. نمی توان همراه با حداقل_رد_ ولت تنظیم کرد.

store_ config

StoreConfig

لیستی از فروشگاه هایی که محصولات شما از آن تحویل داده می شوند. این فقط برای نوع حمل و نقل محلی تحویل معتبر است.

برنامه وفاداری

برنامه وفاداری ارائه شده توسط یک بازرگان.

فیلدها
loyalty_ program_ tiers[]

LoyaltyProgramTiers

اختیاری. برنامه وفاداری ردیف این سرویس حمل و نقل.

program_ label

string

این برچسب برنامه وفاداری است که در تنظیمات برنامه وفاداری شما در مرکز بازرگان تنظیم شده است. این زیرمجموعه به Google اجازه می دهد تا برنامه وفاداری شما را به پیشنهادات واجد شرایط نقشه برداری کند.

برنامه نویسان

زیر مجموعه برنامه وفاداری بازرگانان.

فیلدها
tier_ label

string

متمایز بودن برچسب Tier [tier_label] متمایز از مزایای سطح بین هر ردیف است. این مقدار همچنین در تنظیمات برنامه شما در مرکز بازرگان تنظیم شده است ، و حتی اگر برنامه وفاداری شما فقط 1 ردیف داشته باشد ، برای تغییر منبع داده لازم است.

نوع کشتی

نوع حمل و نقل خدمات حمل و نقل.

Enums
SHIPMENT_TYPE_UNSPECIFIED این سرویس نوع حمل و نقل را مشخص نکرد.
DELIVERY این سرویس به آدرس انتخاب شده توسط مشتری سفارش می دهد.
LOCAL_DELIVERY این سرویس به آدرس انتخاب شده توسط مشتری سفارش می دهد. این سفارش از یک فروشگاه محلی در نزدیکی ارسال می شود.
COLLECTION_POINT این سرویس به آدرس انتخاب شده توسط مشتری سفارش می دهد. سفارش از یک نقطه جمع آوری ارسال می شود.

با استابون

لیستی از فروشگاه هایی که محصولات شما از آن تحویل داده می شوند. این فقط برای نوع حمل و نقل محلی تحویل معتبر است.

فیلدها
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 روز تحویل ، از ارائه خدمات حمل و نقل در روز تحویل محلی خودداری کنند. به عنوان مثال ، اگر سرویس حمل و نقل تحویل یک روزه را تعریف کند ، و از آن گذشته است ، این قسمت را به نتایج true در نرخ سرویس حمل و نقل محاسبه شده بازگشت NO_DELIVERY_POST_CUTOFF تنظیم می کند. در همان مثال ، تنظیم این قسمت بر روی نتایج false در زمان حمل و نقل محاسبه شده یک روز. این فقط برای تحویل محلی است.

محلی

زمانی که تحویل محلی برای روز به پایان می رسد.

فیلدها
hour

int64

ساعت سفارشات تحویل محلی باید برای پردازش در همان روز قرار گیرد.

minute

int64

سفارشات تحویل محلی دقیقه باید برای پردازش در همان روز قرار گیرد.

storeServiceType

نشان می دهد که آیا همه فروشگاه ها یا فروشگاه های منتخب ، که توسط بازرگان ذکر شده است ، تحویل محلی را ارائه می دهد.

Enums
STORE_SERVICE_TYPE_UNSPECIFIED نوع سرویس فروشگاه را مشخص نکرد.
ALL_STORES نشان می دهد که آیا همه فروشگاه ها ، فعلی و آینده ، که توسط این بازرگان ذکر شده است ، تحویل محلی را ارائه می دهد.
SELECTED_STORES نشان می دهد که فقط فروشگاه های ذکر شده در store_codes واجد شرایط تحویل محلی هستند.

حمل و نقل

تنظیم حمل و نقل حساب بازرگان.

فیلدها
name

string

شناسه. نام منبع تنظیم حمل و نقل. قالب: accounts/{account}/shippingSetting

services[]

Service

اختیاری. لیست خدمات حساب هدف.

warehouses[]

Warehouse

اختیاری. لیستی از انبارها که می توان در services به آنها اشاره کرد.

etag

string

مورد نیاز. این زمینه برای جلوگیری از مسئله Async استفاده می شود. اطمینان حاصل کنید که داده های تنظیم حمل و نقل بین تماس تلفنی و درج تماس تغییر نکرده اند. کاربر باید مراحل زیر را انجام دهد

  1. قسمت ETAG را به عنوان رشته خالی برای ایجاد تنظیم اولیه حمل و نقل تنظیم کنید.

  2. پس از ایجاد اولیه ، قبل از درج تماس ، روش دریافت ETAG و داده های تنظیم حمل و نقل فعلی را فراخوانی کنید.

  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

فیلدها
name

string

شناسه. نام منابع نسخه خدمات. قالب: termsOfService/{version}

region_ code

string

کد منطقه همانطور که توسط CLDR تعریف شده است. این یا کشوری است که TOS به طور خاص برای آن کشور اعمال می شود یا 001 هنگامی که می توان همان TermsOfService در هر کشور امضا کرد. با این حال توجه داشته باشید که هنگام امضای TOS که در سطح جهان اعمال می شود ، ما هنوز انتظار داریم که یک کشور خاص ارائه شود (این باید کشور تجاری تجاری یا کشور برنامه مشارکت باشد).

kind

TermsOfServiceKind

نوع این نسخه خدمات برای آن اعمال می شود.

external

bool

این که آیا این شرایط نسخه خدمات خارجی است یا خیر. شرایط خارجی نسخه های خدمات فقط از طریق فرآیندهای خارجی قابل توافق است و نه مستقیماً توسط بازرگان از طریق UI یا API.

file_ uri

string

URI برای شرایط فایل خدماتی که باید برای امضای کاربران نمایش داده شود.

شرایط

این منبع نمایانگر وضعیت توافق نامه برای یک حساب خاص و شرایط نوع خدمات است. دولت به شرح زیر است:

  • اگر بازرگان شرایط خدمات را پذیرفته باشد: پذیرفته شده جمع می شود ، در غیر این صورت خالی خواهد بود
  • اگر بازرگان باید شرایط خدمات را امضا کند: مورد نیاز جمع خواهد شد ، در غیر این صورت خالی خواهد بود.

توجه داشته باشید که هر دو مورد نیاز و پذیرفته شده می توانند حضور داشته باشند. در این حالت ، شرایط accepted خدمات دارای تاریخ انقضا در قسمت معتبر_ونتیل خواهد بود. شرایط required برای خدمات باید قبل از valid_until پذیرفته شود تا حساب برای ادامه توافق نامه معتبر ادامه یابد. هنگام پذیرش شرایط جدید خدمات ، انتظار داریم 3PS متن مرتبط با توافق نامه خدمات داده شده را نمایش دهد (URL به پرونده حاوی متن در پیام مورد نیاز زیر به عنوان TOS_FILE_URI اضافه می شود. پذیرش واقعی شرایط خدمات انجام می شود با فراخوانی پذیرش در مورد منابع خدمات .

فیلدها
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

شرایط پذیرفته شده خدمات از این نوع و برای منطقه مرتبط با منطقه

required

Required

شرایط خدمات مورد نیاز

اصطلاحات OFServiceKind

اصطلاحات خدمات.

Enums
TERMS_OF_SERVICE_KIND_UNSPECIFIED مقدار پیش فرض این مقدار بلااستفاده است.
MERCHANT_CENTER برنامه مرکز بازرگان.

بار

جدول زمان ترانزیت ، تعداد روزهای کاری که در ترانزیت بر اساس ابعاد ردیف و ستون می گذرد. یا 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 مطابقت دارد.

ترانسیمروس

اگر فقط یک مجموعه بعد از postal_code_group_names یا transit_time_labels وجود داشته باشد ، هر یک چندین ردیف وجود دارد که یک مقدار برای آن بعد دارند. اگر دو بعد وجود داشته باشد ، هر سطر با یک postal_code_group_names و ستون ها (مقادیر) به یک transit_time_labels مطابقت دارد.

فیلدها
values[]

TransitTimeValue

مورد نیاز. محدوده زمان ترانزیت (MIN-MAX) در روزهای کاری.

مقادیر متعالی

محدوده زمان ترانزیت (MIN-MAX) در روزهای کاری.

فیلدها
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

مورد نیاز. لیست قسمتهای به روز شده.

updateautofeedsettingsrequest

پیام را برای روش UpdateAutofeedSettings درخواست کنید.

فیلدها
autofeed_ settings

AutofeedSettings

مورد نیاز. نسخه جدید تنظیم Autofeed.

update_ mask

FieldMask

مورد نیاز. لیست قسمتهای به روز شده.

UpdateBusinessIdentityRequest

پیام را برای روش UpdateBusinessIdentity درخواست کنید.

فیلدها
business_ identity

BusinessIdentity

مورد نیاز. نسخه جدید هویت تجاری.

update_ mask

FieldMask

مورد نیاز. لیست قسمتهای به روز شده.

UpdateBusinessInforequest

پیام را برای روش UpdateBusinessInfo درخواست کنید.

فیلدها
business_ info

BusinessInfo

مورد نیاز. نسخه جدید اطلاعات کسب و کار.

update_ mask

FieldMask

مورد نیاز. لیست قسمتهای به روز شده.

UpdateMailPreferencesRequest

درخواست پیام برای روش UpdateMailPreferences.

فیلدها
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/{email}

از me استفاده کنید تا به آدرس ایمیل خود ، به عنوان مثال accounts/{account}/users/me مراجعه کنید.

state

State

فقط خروجی وضعیت کاربر.

access_ rights[]

AccessRight

اختیاری. حقوق دسترسی کاربر.

ایالت

حالت های احتمالی یک کاربر.

Enums
STATE_UNSPECIFIED مقدار پیش فرض این مقدار بلااستفاده است.
PENDING کاربر در انتظار تأیید است. در این حالت ، کاربر ابتدا باید قبل از انجام اقدامات دیگر ، دعوت را بپذیرد.
VERIFIED کاربر تأیید شده است.

ارزش

مقدار واحد یک گروه نرخ یا مقدار سلول جدول گروه نرخ. دقیقاً یکی از no_shipping ، flat_rate ، price_percentage ، carrier_rateName ، subtable_name باید تنظیم شود.

فیلدها
no_ shipping

bool

اگر درست باشد ، محصول قابل حمل نیست. باید در صورت تنظیم صحیح باشد ، فقط در صورت تنظیم همه زمینه های دیگر قابل تنظیم است.

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" . نام این سرویس باید در لیست EDDSupportedService باشد.

warehouse

string

مورد نیاز نام انبار. این باید با [انبار] [Shippingsetting.warehouse.name] مطابقت داشته باشد

انبار

آخرین زمان روز که می توان یک سفارش را پذیرفت و پردازش را آغاز کرد. سفارشات بعدی در روز بعد پردازش می شوند. زمان بر اساس کد پستی انبار است.

فیلدها
hour

int32

مورد نیاز ساعت زمان قطع که تا زمانی که باید سفارش را در همان روز توسط انبار پردازش کند. ساعت بر اساس منطقه زمانی انبار است.

minute

int32

مورد نیاز دقیقه از زمان قطع ، تا زمانی که باید سفارش را در همان روز توسط انبار پردازش کرد. دقیقه بر اساس منطقه زمانی انبار است.