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

AccountTax Service

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

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

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

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

سرویس پشتیبانی از 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 منجر به حذف تمام حساب های فرعی آن می شود. اجرای این روش نیاز به دسترسی ادمین دارد.

محدوده مجوز

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

به روز رسانی حساب کاربری

rpc UpdateAccount( UpdateAccountRequest ) returns ( Account )

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

محدوده مجوز

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

ListOnlineReturnPolicies

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

محدوده مجوز

به محدوده 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 یافت می شود.

اجازه دسترسی

حق دسترسی

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 .

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 موضوع پیشنهادی برای بهبود است.

مالیات حساب

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

زمینه های
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

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

روز هفته

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

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

نرخ حامل

فهرستی از نرخ‌های شرکت مخابراتی که می‌توان با استفاده از 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

CreateAndConfigureAccountRequest

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

زمینه های
account

Account

ضروری. حسابی که باید ایجاد شود.

users[]

CreateUserRequest

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

service[]

AddAccountService

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

accept_terms_of_service

AcceptTermsOfService

اختیاری. شرایط خدمات (ToS) بلافاصله پس از ایجاد حساب پذیرفته می شود.

AcceptTermsOfService

ارجاع به منبع شرایط خدمات.

زمینه های
name

string

ضروری. نام منبع نسخه شرایط خدمات.

region_code

string

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

ضروری. کاربر برای ایجاد.

خدمات مشتری

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

زمینه های
uri

string

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

email

string

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

phone

PhoneNumber

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

Cutoff Time

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

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

زمان تحویل

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

زمینه های
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

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

غیرفعال کردن برنامه 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}

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} قالب شناسه این است: {TermsOfServiceKind}-{country}

GetTermsOfServiceRequest

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

زمینه های
name

string

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

GetUserRequest

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

زمینه های
name

string

ضروری. نام کاربری که باید بازیابی شود. قالب: accounts/{account}/users/{email}

همچنین امکان بازیابی کاربر متناظر با تماس‌گیرنده با استفاده از me به جای آدرس ایمیل مانند accounts/{account}/users/me وجود دارد.

سرصفحه ها

یک لیست غیر خالی از سرصفحه های ردیف یا ستون برای یک جدول. دقیقاً یکی از prices ، weights ، num_items ، postal_code_group_names یا location باید تنظیم شود.

زمینه های
prices[]

Price

ضروری. فهرستی از کرانه های بالای قیمت سفارش. مقدار آخرین قیمت می تواند بی نهایت باشد با تنظیم قیمت مقدار_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" و "> 50 کیلوگرم" است. تمام وزنهای موجود در یک سرویس باید یک واحد داشته باشند. باید غیر خالی باشد. باید به جز -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) از صفحه اصلی فروشگاه.

درج

درخواست پیام برای روش 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

TimeZone

اختیاری. منطقه زمانی Iana برای بومی سازی زمان در زمینه های قابل خواندن انسان استفاده می کرد. به عنوان مثال "آمریکا/LOS_ANGELES". اگر تنظیم نشده باشد ، از "America/LOS_ANGELES" استفاده خواهد شد.

لیست

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

زمینه های
account_issues[]

AccountIssue

مسائل مربوط به حساب مشخص شده.

next_page_token

string

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

listAccountTaxRequest

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

زمینه های
parent

string

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

page_size

int32

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

page_token

string

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

listAccountTaxResponse

پاسخ به لیست مالیات حساب درخواست این روش فقط می تواند در یک حساب چند مشتری فراخوانی شود ، در غیر این صورت خطایی را برمی گرداند.

زمینه های
account_taxes[]

AccountTax

صفحه تنظیمات حساب کاربری

next_page_token

string

نشانه بازیابی صفحه بعدی تنظیمات مالیات حساب.

listAccountSrequest

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

زمینه های
page_size

int32

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

page_token

string

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

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

filter

string

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

لیست

پیام پاسخ برای روش 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

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

مربوط به

شرایط موجود

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

خط مشی

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

زمینه های
type

Type

نوع سیاست.

days

int64

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

بازگرداندن

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

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

تلفن

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

نماد
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 وقتی برنامه در سطح جهان اعمال می شود.

حالت

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

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

نوع کشتی

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

نماد
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

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

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

حمل و نقل

حساب بازرگان [تنظیمات حمل و نقل] (( https://support.google.com/merchants/answer/6069284) .

زمینه های
name

string

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

services[]

Service

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

warehouses[]

Warehouse

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

etag

string

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

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

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

  3. اطلاعات تنظیم حمل و نقل را تغییر دهید.

  4. روش درج تماس با اطلاعات تنظیم حمل و نقل تحت تعقیب با ETAG به دست آمده از مرحله 2.

  5. در صورت تغییر داده های تنظیم حمل و نقل بین مرحله 2 و مرحله 4 ، درخواست وارد می شود زیرا ETAG هر بار تغییر می کند که داده های تنظیم حمل و نقل تغییر می کنند. کاربر باید مرحله 2-4 را با ETAG جدید تکرار کند.

جدول

یک جدول که گروه نرخ را تعریف می کند ، هنگامی که single_value به اندازه کافی بیانگر نیست.

زمینه های
rows[]

Row

ضروری. لیست ردیف هایی که جدول را تشکیل می دهند. باید به همان طول row_headers داشته باشد.

name

string

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

row_headers

Headers

ضروری. هدرهای ردیف های جدول.

column_headers

Headers

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

مالیات

همگرایی نوع اصلی

درصد میکرو: 100 ٪ = 1 000 000 و 1 ٪ = 10 000 نمی تواند منفی باشد.

اطلاعات مربوط به Nexus مالیاتی و پارامترهای مربوطه که برای سفارشات تحویل داده شده به منطقه تحت پوشش یک مدیر مالیاتی واحد اعمال می شود. Nexus زمانی ایجاد می شود که یک بازرگان در منطقه ای که توسط مدیر مالیات اداره می شود ، تجارت می کند (فقط ایالات متحده برای پیکربندی Nexus پشتیبانی می شود). اگر بازرگان در یک کشور ایالات متحده وجود داشته باشد ، بازرگان باید به کلیه مقامات مالیاتی مرتبط با مقصد حمل و نقل مالیات بپردازد. شناسه بعدی: 8

زمینه های
region_code

string

کد منطقه ای که در آن این قانون قابل اجرا است

shipping_taxed

bool

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

effective_time_period

Interval

ضروری. دوره زمانی که این قانون مؤثر است. اگر مدت زمان موجود در لیست مؤثر باشد ، پس از آن باز شده به آینده پایان یافته است. شروع این دوره زمانی فراگیر است و پایان آن منحصر به فرد است.

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

int64

Admin_ID یا معیارهای منطقه ای که در آن این قانون کاربرد دارد.

post_code_range

TaxPostalCodeRange

دامنه کدهای پستی که در آن این قانون کاربرد دارد.

rate_calculation میدان اتحادیه_ محاسبه. راه محاسبه نرخ مالیات برای تحویل به منطقه این مدیر چیست. فقط می توان در ایالات متحده قرار گرفت. rate_calculation فقط می تواند یکی از موارد زیر باشد:
use_google_rate

bool

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

self_specified_rate_micros

int64

نرخ ثابت در MICROS ، که در آن 100 ٪ = 1_000_000 مشخص شده است. مناسب برای کشورهای مبتنی بر مبدا.

مالیات بر

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

زمینه های
start

string

ضروری. شروع محدوده کد پستی ، که در محدوده آن نیز کوچکترین است.

end

string

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

شرایط استفاده از خدمات

یک 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

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

نماد
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

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

UpdateAcountTaxRequest

درخواست به روزرسانی تنظیمات مالیاتی

زمینه های
account_tax

AccountTax

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

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

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

حالت

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

نماد
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

ضروری. آخرین زمان روز که می توان یک سفارش را پذیرفت و پردازش را آغاز کرد. Later orders will be processed in the next day. The time is based on the warehouse postal code.

handling_days

int64

ضروری. The number of days it takes for this warehouse to pack up and ship an item. This is on the warehouse level, but can be overridden on the offer level based on the attributes of an item.

business_day_config

BusinessDayConfig

Business days of the warehouse. If not set, will be Monday to Friday by default.

WarehouseBasedDeliveryTime

Indicates that the delivery time should be calculated per warehouse (shipping origin location) based on the settings of the selected carrier. When set, no other transit time related field in delivery_time should be set.

زمینه های
carrier

string

ضروری. Carrier, such as "UPS" or "Fedex" .

carrier_service

string

ضروری. Carrier service, such as "ground" or "2 days" . The name of the service must be in the eddSupportedServices list.

warehouse

string

ضروری. Warehouse name. This should match [warehouse][ShippingSetting.warehouses.name]

WarehouseCutoffTime

The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code.

زمینه های
hour

int32

ضروری. Hour of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Hour is based on the timezone of warehouse.

minute

int32

ضروری. Minute of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Minute is based on the timezone of warehouse.