Package google.shopping.merchant.accounts.v1beta

אינדקס

AccountIssueService

שירות לתמיכה ב-API של AccountIssueService.

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

רשימה של כל הבעיות בחשבון Merchant Center.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

AccountTaxService

ניהול נתוני הגדרות מס ברמת החשבון.

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

AccountsService

שירות לתמיכה ב-Accounts API.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

יצירת חשבון Merchant Center עצמאי עם הגדרות נוספות. הוספת המשתמש ששלח את הבקשה כאדמין בחשבון החדש.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
DeleteAccount

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)

להציג רשימה של כל חשבונות המשנה של חשבון מרובה לקוחות מסוים. זוהי wrapper במסגרת הנוחות של השיטה 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.

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

שירות לתמיכה ב-Business info 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

שירות לתמיכה ב-API של EmailPreferences.

השירות הזה מאפשר אחזור ועדכון של העדפות אימייל רק עבור משתמשים מאומתים.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

הפונקציה מחזירה את העדפות האימייל של משתמש בחשבון Merchant Center.

השתמשו בכינוי name=accounts/*/users/me/emailPreferences כדי לקבל העדפות עבור המשתמש המאומת.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

מעדכן את העדפות האימייל של משתמש בחשבון Merchant Center. משתמשי ה-MCA צריכים לציין את החשבון ה-MCA ולא את חשבון המשנה של ה-MCA.

העדפות שלא נבחרו במפורש במסכת העדכון לא יעודכנו.

לא ניתן להשתמש בעדכונים שבהם יצוין ערך סטטוס ההסכמה 'לא אושר'.

השתמשו בכינוי name=accounts/*/users/me/emailPreferences כדי לעדכן את ההעדפות עבור המשתמש המאומת.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

HomepageService

שירות לתמיכה ב-API לדף הבית של חנות.

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

תביעת בעלות על דף הבית של חנות. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

אם כבר נתבעה בעלות על דף הבית, המערכת תבדוק שוב את האימות (אלא אם המוכר פטור מתביעת בעלות, שגם פטור מאימות) ותחזיר תשובה מוצלחת. אם כבר אי אפשר לאמת את הבעלות, תוחזר הודעת שגיאה אבל לא תמחק את התלונה. אם הפעולה תיכשל, תוחזר הודעת שגיאה קנונית: * permission_DENIED: למשתמש אין את ההרשאות הדרושות בחשבון MC זה; * FAILED_PRE conditions: - החשבון אינו חשבון 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.
UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

מבטל את תביעת הבעלות על דף הבית של חנות. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

מעדכן את דף הבית של חנות. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

OnlineReturnPolicyService

השירות מאפשר למוֹכר לנהל את ההגדרה של מדיניות החזרת מוצרים שחרטה, וכולל מדיניות החזרת מוצרים גם במודעות וגם בכרטיסי מוצר חינמיים

התוכניות השונות. ה-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.

ProgramsService

שירות לניהול תוכנית.

התוכניות מספקות מנגנון להוספת פונקציונליות לחשבונות המוכרים. דוגמה אופיינית לכך היא התוכנית כרטיסי מוצר חינמיים, שמאפשרת להציג ב-Google בחינם מוצרים מחנות של מוֹכר.

בשירות הזה מפורטות שיטות לאחזור ההשתתפות של מוֹכר בכל התוכניות הזמינות, בנוסף לשיטות להפעלה או להשבתה של ההשתתפות באופן מפורש בכל תוכנית.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

להשבית את ההשתתפות בתוכנית שצוינה עבור החשבון. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

להפעיל את ההשתתפות בתוכנית שצוינה בחשבון. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

אחזור של התוכנית שצוינה עבור החשבון.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

אחזור כל התוכניות של החשבון.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

RegionsService

ניהול של הגדרת האזורים.

ה-API הזה מגדיר את מודל המשאבים הבא:

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

ההגדרה הזו יוצרת את הגדרת האזור בחשבון Merchant Center. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

מחיקת הגדרת אזור מחשבון Merchant Center שלכם. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

אחזור אזור שהוגדר בחשבון Merchant Center.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

בתיבת הדו-שיח הזו מפורטים האזורים בחשבון Merchant Center שלכם.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

לעדכן הגדרת אזור בחשבון Merchant Center. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

ShippingSettingsService

שירות לקבלת מידע על הגדרת המשלוח של קריאה לשיטה לפי שיטת ה-Merchant API.

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

אחזור פרטים של הגדרות משלוח.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

מחליפים את הגדרת המשלוח של המוכר בהגדרת המשלוח של הבקשה. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

TermsOfServiceAgreementStateService

שירות לתמיכה ב-API של TermsOfServiceAgreementState.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

מחזירה את המצב של הסכם התנאים וההגבלות.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

אחזור של מצב ההסכם עבור התנאים וההגבלות של האפליקציה.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

TermsOfServiceService

שירות לתמיכה ב-API של TermsOfService.

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

מקבלים TermsOfService. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

אחזור TermsOfService שמשויך לגרסה שסופקה.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

מאחזר את הגרסה האחרונה של TermsOfService עבור kind ו-region_code נתונים.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

UserService

שירות לתמיכה ב-API למשתמש.

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

יצירת משתמש בחשבון Merchant Center. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

מחיקת משתמש בחשבון Merchant Center. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
GetUser

rpc GetUser(GetUserRequest) returns (User)

אחזור של משתמש בחשבון Merchant Center.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

רשימה של כל המשתמשים בחשבון Merchant Center.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

עדכון משתמש בחשבון Merchant Center. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

AcceptTermsOfServiceRequest

בקשת הודעה ל-method AcceptTermsOfService.

שדות
name

string

חובה. שם המשאב של גרסת התנאים וההגבלות. פורמט: termsOfService/{version}
account

string

חובה. החשבון שעבורו צריך לאשר את התנאים וההגבלות.
region_code

string

חובה. קוד האזור לפי ההגדרה של CLDR. מדובר במדינה שבה התנאים וההגבלות חלים באופן ספציפי על אותה מדינה, או אם התנאים וההגבלות חלים בכל העולם, או קוד 001.

אושרו

תיאור של התנאים וההגבלות הקבילים.

שדות
terms_of_service

string

termsOfService הקבילים.
accepted_by

string

החשבון שבו נרשמה האישור. החשבון יכול להיות החשבון עצמו, או חשבון ה-MCA כשמדובר בחשבונות משנה.
valid_until

Date

אם המדיניות מוגדרת, היא מצהירה שTermsOfService המקובלים תקפים רק עד סוף התאריך הזה (לפי שעון UTC). יש לאשר אישור חדש לפני כן. המידע של ה-TermsOfService הנדרשים מופיע בהודעה החובה.

AccessRight

הרשאת הגישה הנכונה.

טיפוסים בני מנייה (enum)
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.

AccountIssue

AccountIssue.

שדות
name

string

מזהה. שם המשאב של הבעיה בחשבון. פורמט: accounts/{account}/issues/{id}
title

string

השם המותאם לשוק המקומי של הבעיה.
severity

Severity

החומרה הכוללת של הבעיה.
impacted_destinations[]

ImpactedDestination

ההשפעה של הבעיה על יעדים שונים.
detail

string

פרטים נוספים על הבעיה שמותאמים לשוק המקומי.
documentation_uri

string

קישור אל מרכז העזרה של Merchant Center יאפשר לך לקבל מידע נוסף על הבעיה וללמוד איך לפתור אותה.

ImpactedDestination

ההשפעה של הבעיה על יעד מסוים.

שדות
impacts[]

Impact

ההשפעה (השלילית) של אזורים שונים על היעד הנתון.
reporting_context

ReportingContextEnum

ההקשר של הדיווח שהושפע.

השפעה

ההשפעה של הבעיה על אזור מסוים.

שדות
region_code

string

קוד האזור במאגר CLDR שבו רלוונטית הבעיה הזו.
severity

Severity

חומרת הבעיה ביעד ובאזור.

מידת החומרה

כל מידות החומרה האפשריות של בעיות.

טיפוסים בני מנייה (enum)
SEVERITY_UNSPECIFIED חוּמרה אינה ידועה.
CRITICAL הבעיה גורמת לכך שהמוצרים לא מוצגים.
ERROR הבעיה יכולה להשפיע על מוצרים (בעתיד) או להצביע על בעיות במוצרים.
SUGGESTION הבעיה היא הצעה לשיפור.

AccountTax

הגדרות המס של חשבון מוכר. בכל השיטות נדרש תפקיד אדמין.

שדות
name

string

מזהה. השם של הגדרת המס. פורמט: "{account_tax.name=accounts/{account}}"
account

int64

פלט בלבד. מספר החשבון שאליו שייכות הגדרות המס של החשבון.
tax_rules[]

TaxRule

כללי מס. "מגדירים את כללי המס בכל אזור. לא יוצג מס אם לא הוגדר באזור כלל".

כתובת

הכתובת למשלוח של המחסן.

שדות
street_address

string

חלק של הכתובת ברמת הרחוב. לדוגמה: 111w 31st Street.
city

string

חובה. עיר, עיירה או קהילה. עשוי לכלול גם רשויות מוניציפאליות או אזורי משנה (לדוגמה, שכונות או פרברים).
administrative_area

string

חובה. חלוקת משנה מנהלית ברמה העליונה של המדינה. לדוגמה, מדינה כמו קליפורניה (CA) או מחוז כמו קוויבק (QC).
postal_code

string

חובה. מיקוד (לדוגמה "94043").
region_code

string

חובה. קוד מדינה במאגר CLDR (לדוגמה, 'US').

BusinessDayConfig

ימי העסקים במחסן.

שדות
business_days[]

Weekday

חובה. ימי עסקים קבועים. השדה לא יכול להיות ריק.

יום חול

טיפוסים בני מנייה (enum)
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

אוסף של מידע שקשור לזהות של עסק.

שדות
name

string

מזהה. שם המשאב של זהות העסק. פורמט: accounts/{account}/businessIdentity
black_owned

IdentityAttribute

זה שינוי אופציונלי. מציין אם העסק מזדהה כעסק בבעלות אדם שחור. השדה האופציונלי הזה יהיה זמין רק למוכרים שמדינת העסק שלהם מוגדרת כ-US. היא גם לא רלוונטית לאתרי מכירה בזירות מסחר או לזירות מסחר.
women_owned

IdentityAttribute

זה שינוי אופציונלי. מציין אם העסק מזהה את עצמו כעסק בבעלות אישה. השדה האופציונלי הזה יהיה זמין רק למוכרים שמדינת העסק שלהם מוגדרת כ-US. היא גם לא רלוונטית לאתרי מכירה בזירות מסחר או לזירות מסחר.
veteran_owned

IdentityAttribute

זה שינוי אופציונלי. מציין אם העסק מזהה את עצמו כעסק בבעלות יוצא מן הכלל. השדה האופציונלי הזה יהיה זמין רק למוכרים שמדינת העסק שלהם מוגדרת כ-US. היא גם לא רלוונטית לאתרי מכירה בזירות מסחר או לזירות מסחר.
latino_owned

IdentityAttribute

זה שינוי אופציונלי. מציין אם העסק מזדהה כעסק בבעלות אדם לטיני. השדה האופציונלי הזה יהיה זמין רק למוכרים שמדינת העסק שלהם מוגדרת כ-US. היא גם לא רלוונטית לאתרי מכירה בזירות מסחר או לזירות מסחר.
small_business

IdentityAttribute

זה שינוי אופציונלי. מציין אם העסק מזדהה כעסק קטן. השדה האופציונלי הזה יהיה זמין רק למוכרים שמדינת העסק שלהם מוגדרת כ-US. היא גם לא רלוונטית לזירות מסחר.

IdentityAttribute

כל המידע שקשור למאפיין זהות.

שדות
identity_declaration

IdentityDeclaration

חובה. הצהרת הזהות של המאפיין הזה.

IdentityDeclaration

כל ההגדרות האפשריות להצהרה על זהות.

טיפוסים בני מנייה (enum)
IDENTITY_DECLARATION_UNSPECIFIED ערך ברירת מחדל שמציין שלא בוצעה בחירה.
SELF_IDENTIFIES_AS מציין שהחשבון מזדהה עם המאפיין.
DOES_NOT_SELF_IDENTIFY_AS מציין שהחשבון לא מזדהה עם המאפיין.

PromotionsConsent

כל ההגדרות האפשריות בנוגע למבצעים שקשורים לזהות העסק.

טיפוסים בני מנייה (enum)

BusinessInfo

אוסף של מידע שקשור לעסק.

שדות
name

string

מזהה. שם המשאב של פרטי העסק. פורמט: accounts/{account}/businessInfo
address

PostalAddress

זה שינוי אופציונלי. כתובת העסק.
phone

PhoneNumber

זה שינוי אופציונלי. מספר הטלפון של העסק.
phone_verification_state

PhoneVerificationState

פלט בלבד. מצב האימות הטלפוני של העסק.
customer_service

CustomerService

זה שינוי אופציונלי. שירות הלקוחות של העסק.

CarrierRate

רשימה של תעריפים של חברות תובלה שאפשר להתייחס אליהם לפי main_table או single_value.

שדות
name

string

חובה. שם התעריף של חברת התובלה. חייב להיות ייחודי לכל קבוצת תעריפים.
carrier

string

חובה. השירות של ספק הסלולר, למשל "UPS" או "Fedex".
carrier_service

string

חובה. השירות של ספק הסלולר, למשל "ground" או "2 days".
origin_postal_code

string

חובה. מקור המשלוח בתעריף הזה של חברת התובלה.
percentage_adjustment

string

זה שינוי אופציונלי. הכפלה של תעריף המשלוח כמספר בסימון עשרוני. יכול להיות שלילי. לדוגמה: הדגל "5.4" מעלה את השיעור ב-5.4%, והשיטה "-3" מקטינה את השיעור ב-3%.
flat_adjustment

Price

זה שינוי אופציונלי. ערך מוסף של תעריף משלוח. יכול להיות שלילי. לדוגמה, { "amount_micros": 1, "currency_code" : "USD" } מוסיף 1 $לתעריף, { "amount_micros": -3, "currency_code" : "USD" } מסיר 3 $מהתעריף.

ClaimHomepageRequest

בקשת הודעה ל-method ClaimHomepage.

שדות
name

string

חובה. השם של דף הבית שעליו רוצים לתבוע בעלות. פורמט: accounts/{account}/homepage

CreateAndConfigureAccountRequest

בקשת הודעה ל-method CreateAndConfigureAccount.

שדות
account

Account

חובה. החשבון ליצירה.
users[]

CreateUserRequest

זה שינוי אופציונלי. משתמשים שיתווספו לחשבון.
service[]

AddAccountService

זה שינוי אופציונלי. אם צוין, שירות חשבון בין החשבון שיש ליצור לבין חשבון הספק יופעל כחלק מתהליך היצירה.
accept_terms_of_service

AcceptTermsOfService

זה שינוי אופציונלי. את התנאים וההגבלות (ToS) שצריך לאשר מיד לאחר יצירת החשבון.

AcceptTermsOfService

הפניה למקור מידע של תנאים והגבלות.

שדות
name

string

חובה. שם המשאב של גרסת התנאים וההגבלות.
region_code

string

חובה. קוד האזור לפי ההגדרה של CLDR. מדובר במדינה שבה התנאים וההגבלות חלים באופן ספציפי על אותה מדינה, או ב001 אם הם חלים בכל העולם.

AddAccountService

הוראות נוספות להוספת שירותי חשבון במהלך יצירת החשבון.

שדות
שדה איחוד service_type. בשלב הזה יש תמיכה רק בחשבון הורה ריבוי לקוחות. service_type יכול להיות רק אחת מהאפשרויות הבאות:
account_aggregation

Empty

הספק הוא אתר אגרגטור לחשבון.
provider

string

זה שינוי אופציונלי. ספק השירות. פורמט: accounts/{account}

CreateRegionRequest

בקשת הודעה ל-method CreateRegion.

שדות
parent

string

חובה. החשבון שעבורו רוצים ליצור אזור. פורמט: accounts/{account}
region_id

string

חובה. המזהה של האזור, שהוא מזהה ייחודי בכל האזורים של אותו חשבון.
region

Region

חובה. האזור שצריך ליצור.

CreateUserRequest

בקשת הודעה ל-method CreateUser.

שדות
parent

string

חובה. שם המשאב של החשבון שבשבילו ייווצר משתמש. פורמט: accounts/{account}
user_id

string

חובה. כתובת האימייל של המשתמש (לדוגמה john.doe@gmail.com).
user

User

חובה. המשתמש שצריך ליצור.

CustomerService

מידע על שירות הלקוחות.

שדות
uri

string

זה שינוי אופציונלי. ה-URI שבו ניתן למצוא את שירות הלקוחות.
email

string

זה שינוי אופציונלי. כתובת האימייל שבאמצעותה ניתן ליצור קשר עם שירות הלקוחות.
phone

PhoneNumber

זה שינוי אופציונלי. מספר הטלפון שאליו ניתן להתקשר לשירות הלקוחות.

CutoffTime

הגדרת המועד האחרון להזמנה של ימי עסקים.

שדות
hour

int32

חובה. השעה המאוחרת ביותר שבמהלכה צריך לבצע הזמנה כדי שהיא תטופל באותו יום.
minute

int32

חובה. הדקה של המועד האחרון שעד אליו צריך לבצע הזמנה כדי שההזמנה תעובד באותו יום.
time_zone

string

חובה. מזהה אזור זמן. לדוגמה, 'אירופה/ציריך'.

DeleteAccountRequest

בקשת הודעה ל-method DeleteAccount.

שדות
name

string

חובה. שם החשבון שרוצים למחוק. פורמט: accounts/{account}

DeleteRegionRequest

בקשת הודעה ל-method DeleteRegion.

שדות
name

string

חובה. שם האזור שרוצים למחוק. פורמט: accounts/{account}/regions/{region}

DeleteUserRequest

בקשת הודעה ל-method DeleteUser.

שדות
name

string

חובה. שם המשתמש שרוצים למחוק. פורמט: accounts/{account}/users/{email}

אפשר גם למחוק את המשתמש התואם למתקשר באמצעות me במקום כתובת אימייל כמו accounts/{account}/users/me.

DeliveryTime

הזמן שהוקדש להיבטים שונים, מרגע קבלת המוצר ועד למסירת המוצר.

שדות
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

זה שינוי אופציונלי. מציין שיש לחשב את זמן האספקה לכל מחסן (מיקום המוצא של המשלוח) על סמך ההגדרות של חברת התובלה שנבחרה. אחרי ההגדרה הזו, לא יהיה מוגדר אף שדה אחר שקשור לזמן הובלה במאפיין [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime].
min_transit_days

int32

המספר המינימלי של ימי עסקים למשלוח. 0 פירושו מסירה ביום הקנייה, 1 פירושו משלוח ביום המחרת. צריך להגדיר min_transit_days, max_transit_days או transit_time_table, אבל לא את שתי העמודות.
max_transit_days

int32

המספר המקסימלי של ימי עסקים שאפשר להשתמש בהם במעבר. 0 פירושו מסירה ביום הקנייה, 1 פירושו משלוח ביום המחרת. חייב להיות גדול מ-min_transit_days או שווה לו.
cutoff_time

CutoffTime

הגדרת המועד האחרון להזמנה של ימי עסקים. אם לא מגדירים את המועד האחרון להזמנה, ברירת המחדל תהיה 8:00 שעון החוף המערבי.
min_handling_days

int32

מספר ימי העסקים המינימלי שנדרש לפני שההזמנה תישלח. המשמעות של 0 היא שנשלח ביום הקנייה, המשמעות של 1 היא המשלוח ביום המחרת.
max_handling_days

int32

המספר המקסימלי של ימי עסקים שצריך להמתין לפני שההזמנה תישלח. המשמעות של 0 היא שנשלח ביום הקנייה, המשמעות של 1 היא המשלוח ביום המחרת. חייב להיות גדול מ-min_handling_days או שווה לו.
transit_time_table

TransitTable

טבלת זמן הובלה, מספר ימי העסקים שהובלה על סמך מאפייני שורה ועמודה. אפשר להגדיר min_transit_days, max_transit_days או transit_time_table, אבל לא את שתיהן.
handling_business_day_config

BusinessDayConfig

ימי העסקים שבמהלכם אפשר לטפל בהזמנות. אם לא תספקו כתובת, המערכת תתייחס לימי עסקים בימים שני עד שישי.
transit_business_day_config

BusinessDayConfig

ימי העסקים שבמהלכם ההזמנות יכולות להישלח. אם לא תספקו כתובת, המערכת תתייחס לימי עסקים בימים שני עד שישי.

DisableProgramRequest

הודעת בקשה ל-method שלDisableProgram.

שדות
name

string

חובה. שם התוכנית שעבורה יש להשבית את ההשתתפות של החשבון הנתון. פורמט: accounts/{account}/programs/{program}

מרחק

רדיוס מסירה מקסימלי. צריך לעשות זאת רק עבור סוג משלוח מקומי.

שדות
value

int64

ערך מספר שלם של מרחק.
unit

Unit

היחידה עשויה להשתנות בהתאם למדינה, היא כוללת פרמטרים שכוללים מיילים וקילומטרים.

יחידה

היחידה עשויה להשתנות בהתאם למדינה, היא כוללת פרמטרים שכוללים מיילים וקילומטרים.

טיפוסים בני מנייה (enum)
UNIT_UNSPECIFIED לא צוינה יחידה
MILES יחידה במיילים
KILOMETERS יחידה בקילומטרים

EmailPreferences

הקטגוריות של ההתראות שהמשתמש הביע הסכמה או ביטל את ההסכמה לקבל אותן. העדפות האימייל לא כוללות הודעות חשובות, כי המשתמשים לא יכולים לבטל את ההסכמה לקבלת הודעות כאלה.

שדות
name

string

מזהה. השם של EmailPreferences. נקודת הקצה נתמכת רק עבור המשתמש המאומת.
news_and_tips

OptInState

זה שינוי אופציונלי. עדכונים על תכונות חדשות, טיפים ושיטות מומלצות.

OptInState

המצב של העדפת האימייל.

טיפוסים בני מנייה (enum)
OPT_IN_STATE_UNSPECIFIED סטטוס ההצטרפות לא צוין.
OPTED_OUT המשתמש ביטל את ההסכמה לקבל אימייל מהסוג הזה.
OPTED_IN המשתמש הביע הסכמה לקבלת אימייל מהסוג הזה.
UNCONFIRMED המשתמש הביע הסכמה לקבלת אימייל מסוג זה והודעת האישור נשלחה באימייל, אבל המשתמש עדיין לא אישר את הבעת ההסכמה (רלוונטי רק למדינות מסוימות).

EnableProgramRequest

הודעת בקשה ל-method EnableProgram.

שדות
name

string

חובה. שם התוכנית שמאפשרת השתתפות של החשבון הנתון. פורמט: accounts/{account}/programs/{program}

GetAccountRequest

בקשת הודעה ל-method GetAccount.

שדות
name

string

חובה. שם החשבון לאחזור. פורמט: accounts/{account}

GetAccountTaxRequest

בקשה לקבלת הגדרות מס

שדות
name

string

חובה. השם שממנו יישלפו הגדרות המס

GetBusinessIdentityRequest

בקשת הודעה ל-method GetBusinessIdentity.

שדות
name

string

חובה. שם המשאב של זהות העסק. פורמט: accounts/{account}/businessIdentity

GetBusinessInfoRequest

בקשת הודעה ל-method GetBusinessInfo.

שדות
name

string

חובה. שם המשאב של פרטי העסק. פורמט: accounts/{account}/businessInfo

GetEmailPreferencesRequest

בקשת הודעה לשיטת GetEmailPreferences.

שדות
name

string

חובה. שם המשאב EmailPreferences. פורמט: accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

בקשת הודעה ל-method GetHomepage.

שדות
name

string

חובה. השם של דף הבית שצריך לאחזר. פורמט: accounts/{account}/homepage

GetOnlineReturnPolicyRequest

בקשת הודעה ל-method GetOnlineReturnPolicy.

שדות
name

string

חובה. שם מדיניות החזרת המוצרים שיש לאחזר. פורמט: accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

הודעת בקשה לשיטת GetProgram.

שדות
name

string

חובה. שם התוכנית שצריך לאחזר. פורמט: accounts/{account}/programs/{program}

GetRegionRequest

בקשת הודעה ל-method GetRegion.

שדות
name

string

חובה. שם האזור שצריך לאחזר. פורמט: accounts/{account}/regions/{region}

GetShippingSettingsRequest

בקשת הודעה ל-method GetShippingSetting.

שדות
name

string

חובה. השם של הגדרת המשלוח שצריך לאחזר. פורמט: accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

בקשת הודעה ל-method GetTermsOfServiceAgreementState.

שדות
name

string

חובה. שם המשאב של גרסת התנאים וההגבלות. פורמט: accounts/{account}/termsOfServiceAgreementState/{identifier}

GetTermsOfServiceRequest

בקשת הודעה ל-method GetTermsOfService.

שדות
name

string

חובה. שם המשאב של גרסת התנאים וההגבלות. פורמט: termsOfService/{version}

GetUserRequest

בקשת הודעה ל-method GetUser.

שדות
name

string

חובה. שם המשתמש שצריך לאחזר. פורמט: accounts/{account}/users/{email}

ניתן גם לאחזר את המשתמש התואם למתקשר באמצעות me במקום כתובת אימייל כמו ב-accounts/{account}/users/me.

כותרות

רשימה לא ריקה של כותרות של שורות או עמודות בטבלה. יש להגדיר רק אחד מהערכים prices, weights, num_items, postal_code_group_names או location.

שדות
prices[]

Price

חובה. רשימת גבולות עליון של מחיר הזמנה כולל. ערך המחיר האחרון יכול להיות אינסוף אם מגדירים את הערך amount_micros = -1. לדוגמה, [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] מייצג את הכותרות "<= $10", "<= $500" ו-"> $500". לכל המחירים בשירות מסוים צריך להיות מטבע זהה. השדה לא יכול להיות ריק. חייב להיות חיובי מלבד 1-. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.
weights[]

Weight

חובה. רשימת גבולות עליון של משקל ההזמנה כולל. הערך של המשקל האחרון יכול להיות אינסוף על ידי הגדרת הערך amount_micros = -1. לדוגמה, [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] מייצג את הכותרות "<= 10kg", "<= 50kg" ו-"> 50kg". לכל המשקולות בשירות חייבת להיות אותה יחידה. השדה לא יכול להיות ריק. חייב להיות חיובי מלבד 1-. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.
number_of_items[]

string

חובה. רשימה של גבולות עליון מספר כולל של פריטים. הערך האחרון יכול להיות "infinity". לדוגמה: ["10", "50", "infinity"] מייצג את הכותרות '<= 10 פריטים', '<= 50 פריטים' ו-"> 50 פריטים'. השדה לא יכול להיות ריק. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.
postal_code_group_names[]

string

חובה. רשימת השמות של קבוצות הדואר. הערך האחרון יכול להיות "all other locations". לדוגמה: ["zone 1", "zone 2", "all other locations"]. קבוצות המיקוד שאליהן מתבצעת הפניה צריכות להתאים למדינה שבה השירות זמין. השדה לא יכול להיות ריק. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.
locations[]

LocationIdSet

חובה. רשימה של קבוצות של מזהי מיקומים. השדה לא יכול להיות ריק. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.

דף הבית

דף הבית של חנות.

שדות
name

string

מזהה. שם המשאב בדף הבית של החנות. פורמט: accounts/{account}/homepage
claimed

bool

פלט בלבד. האם נתבעה בעלות על דף הבית. מידע נוסף זמין בכתובת https://support.google.com/merchants/answer/176793.
uri

string

חובה. ה-URI (בדרך כלל כתובת URL) של דף הבית של החנות.

InsertShippingSettingsRequest

בקשת הודעה ל-method InsertShippingSetting.

שדות
parent

string

חובה. החשבון שאליו יתווסף המוצר הזה. פורמט: accounts/{account}
shipping_setting

ShippingSettings

חובה. הגרסה החדשה של החשבון.

ListAccountIssuesRequest

בקשת הודעה ל-method ListAccountIssues.

שדות
parent

string

חובה. ההורה שהוא הבעלים של אוסף הבעיות הזה. פורמט: accounts/{account}
page_size

int32

זה שינוי אופציונלי. המספר המקסימלי של בעיות שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא צויין ערך, יוחזרו 50 משתמשים לכל היותר. הערך המקסימלי הוא 100. ערכים מעל 100 יועברו ל-100
page_token

string

זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב-ListAccountIssues. צריך לספק אותה כדי לאחזר את הדף הבא.

במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל-ListAccountIssues חייבים להתאים לקריאה שסיפקה את אסימון הדף.
language_code

string

זה שינוי אופציונלי. הבעיות בתשובה יכללו שדות שאנשים יכולים לקרוא בשפה הנתונה. הפורמט הוא BCP-47, כמו en-US או sr-Latn. אם לא הוזן ערך, ייעשה שימוש ב-en-US.
time_zone

TimeZone

זה שינוי אופציונלי. אזור הזמן IANA משמש להתאמת הזמנים לשוק המקומי בשדות שבני אדם יכולים לקרוא. לדוגמה, 'America/Los_Angeles'. אם המדיניות לא מוגדרת, ייעשה שימוש ב-'America/Los_Angeles'.

ListAccountIssuesResponse

הודעת תשובה לשיטה ListAccountIssues.

שדות
account_issues[]

AccountIssue

הבעיות מהחשבון שצוין.
next_page_token

string

אסימון, שניתן לשלוח בתור page_token כדי לאחזר את הדף הבא. אם השדה הזה יושמט, אין דפים נוספים.

ListAccountTaxRequest

בקשה לרישום כל הגדרות המס של חשבונות המשנה רק עבור המוכר שמגיש את הבקשה. אפשר להפעיל את השיטה הזו רק בחשבון מרובה לקוחות, אחרת היא תחזיר הודעת שגיאה.

שדות
parent

string

חובה. ההורה שהוא הבעלים של אוסף המיסים הזה בחשבון. פורמט: accounts/{account}
page_size

int32

המספר המקסימלי של הגדרות מס שצריך להחזיר בתגובה. המספר משמש לחלוקה לדפים.
page_token

string

האסימון שהוחזר בעקבות הבקשה הקודמת.

ListAccountTaxResponse

תשובה לבקשה לרשימת המס של החשבון. אפשר להפעיל את השיטה הזו רק בחשבון מרובה לקוחות, אחרת היא תחזיר הודעת שגיאה.

שדות
account_taxes[]

AccountTax

דף הגדרות המס של החשבון
next_page_token

string

האסימון לאחזור הדף הבא של הגדרות המס בחשבון.

ListAccountsRequest

בקשת הודעה ל-method ListAccounts.

שדות
page_size

int32

זה שינוי אופציונלי. מספר החשבונות המקסימלי שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא צויין ערך, יוחזרו 250 חשבונות לכל היותר. הערך המקסימלי הוא 500. ערכים מעל 500 יועברו ל-500.
page_token

string

זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב-ListAccounts. צריך לספק אותה כדי לאחזר את הדף הבא.

במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל-ListAccounts חייבים להתאים לקריאה שסיפקה את אסימון הדף.
filter

string

זה שינוי אופציונלי. מסנן אופציונלי שמחזיר רק חשבונות שתואמים למסנן.

הנה כמה דוגמאות למסננים חוקיים:

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

למסננים ברמת החשבון יש את הסמנטיקה הבאה:

  • accountName זהו השדה accountName בחשבון.
  • relationship(...) הנתון הזה מתייחס לקשר בין החשבון לחשבון אחר. בתוך הפונקציה, אפשר לציין עוד יותר את הקשר הזה.

למסננים ברמת היחסים יש את הסמנטיקה הבאה:

  • providerId המספר הזה הוא המספר של החשבון שמשויך לקשר השני. לדוגמה, אם המסנן אמור להגביל לחשבונות שיש להם קשר לחשבון accounts/name/123, יש לסנן את providerId בתור providerId = 123.
  • callerHasAccessToProvider() הפעולה הזו תגביל את החשבונות שייווצרו לחשבונות שיש להם קשר לחשבון אחר שבו גם למשתמש המתקשר יש גישה לחבר השני בקשר (או לספק).
  • externalAccountId זהו מספר החשבון החיצוני שהוגדר לקשר.
  • accountIdAlias זהו האימייל החלופי של מספר החשבון שמוגדר לקשר.
  • service(...) מתייחס לשירות שניתן כחלק מהקשר. הערה: קשר בין שני חשבונות יכול לכלול מספר שירותים.

למסננים ברמת השירות יש את הסמנטיקה הבאה:

  • handshakeState מתייחס למצב לחיצת היד של השירות. כשהשירות נוצר, לפעמים צריך לאשר אותו קודם על ידי הצד השני או שניהם. לכן, שירות יכול להיות במצב PENDING או APPROVED.
  • type זהו סוג השירות. הערכים האפשריים הם:
    • ACCOUNT_MANAGEMENT הספק מנהל את החשבון.
    • ACCOUNT_AGGREGATION הספק הוא אתר אגרגטור של החשבון.

המסנן פועל לפי קבוצת משנה של מפרט מסנן AIP ולפי הדקדוק הרשמי של EBNF. הדקדוק של המסנן הזה מגביל וספציפי יותר

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

כמו כן, התנאים הבאים חלים:

  • כל שדה בשילוב יכול להופיע פעם אחת בלבד (לדוגמה, אפשר לסנן לפי accountName רק פעם אחת ברמת החשבון, או שאפשר לסנן לפי providerId רק פעם אחת בכל רמת קשר).
  • בשדות מחרוזת (כמו accountName או accountIdAlias), אפשר להביע אופרטור CONTAINS על ידי הוספת השאילתה ב-*. לדוגמה, הפונקציה accountName = "*foo*" תחזיר את כל החשבונות עם accountName שמכיל foo. מבחינה אורתוגונלית, אפשר לבטא אופרטור NOT_CONTAINS באמצעות !=. לדוגמה, הפונקציה accountName != "*foo*" תחזיר את כל החשבונות עם accountName שלא מכיל foo. הערה: ניתן לחפש חשבונות עם accountName שמכילים את תו הכוכב * באמצעות ***.
  • המערכת מתעלמת מרווחים לבנים נוספים.
  • כל הערכים מלבד ערכים מספריים בלבד חייבים להיות מוקפים במירכאות כפולות.
  • אם משתמשים בצד שלישי, החיבורים בכל צד חייבים להוסיף סוגריים, גם אם החיבור כולל רק ביטוי אחד. אסור להשתמש בסוגריים בשום מקום אחר, חוץ מהפעלות של פונקציות (כמו relationship או service). זאת כדי להמחיש בבירור שקישור חזק יותר ממילים אחרות באופן לוגי.

ListAccountsResponse

הודעת תשובה לשיטה ListAccounts.

שדות
accounts[]

Account

החשבונות שתואמים לListAccountsRequest.
next_page_token

string

אסימון, שניתן לשלוח בתור page_token כדי לאחזר את הדף הבא. אם השדה הזה יושמט, אין דפים נוספים.

ListOnlineReturnPoliciesRequest

בקשת הודעה ל-method ListOnlineReturnPolicies.

שדות
parent

string

חובה. חשבון המוכר/ת שלגביו צריכה להופיע מדיניות החזרת מוצרים. פורמט: accounts/{account}
page_size

int32

זה שינוי אופציונלי. המספר המקסימלי של OnlineReturnPolicy משאבים שצריך להחזיר. השירות מחזיר פחות מהערך הזה אם מספר מדיניות החזרת המוצרים של המוכר הנתון נמוך מהערך pageSize. ערך ברירת המחדל הוא 10. הערך המקסימלי הוא 100. אם צוין ערך שגבוה מהמקסימום, הערך של pageSize יוגדר כברירת מחדל לערך המקסימלי
page_token

string

זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב-ListOnlineReturnPolicies. צריך לספק את אסימון הדף כדי לאחזר את הדף הבא.

במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל-ListOnlineReturnPolicies חייבים להתאים לקריאה שסיפקה את אסימון הדף. האסימון שהוחזר כ-nextPageToken בתגובה לבקשה הקודמת.

ListOnlineReturnPoliciesResponse

הודעת תשובה לשיטה ListOnlineReturnPolicies.

שדות
online_return_policies[]

OnlineReturnPolicy

מדיניות החזרת המוצרים שאוחזרה.
next_page_token

string

אסימון, שניתן לשלוח בתור pageToken כדי לאחזר את הדף הבא. אם השדה הזה יושמט, אין דפים נוספים.

ListProgramsRequest

הודעת בקשה לשיטה ListPrograms.

שדות
parent

string

חובה. שם החשבון שעבורו רוצים לאחזר את כל התוכניות. פורמט: accounts/{account}
page_size

int32

זה שינוי אופציונלי. המספר המקסימלי של תוכניות שצריך להחזיר בתגובה אחת. אם לא צוין (או 0), ייעשה שימוש בגודל ברירת מחדל של 1,000. הערך המקסימלי הוא 1,000. ערכים מעל 1,000 יועברו ל-1,000.
page_token

string

זה שינוי אופציונלי. אסימון המשך, שהתקבל מקריאה קודמת של ListPrograms. צריך לספק את הכתובת הזו כדי לאחזר את הדף הבא.

ListProgramsResponse

הודעת תגובה לשיטת ListPrograms.

שדות
programs[]

Program

התוכניות של החשבון הנתון.
next_page_token

string

אסימון שאפשר לשלוח בתור page_token כדי לאחזר את הדף הבא. אם השדה הזה יושמט, אין דפים נוספים.

ListRegionsRequest

בקשת הודעה ל-method ListRegions.

שדות
parent

string

חובה. החשבון שעבורו יש לרשום את האזורים. פורמט: accounts/{account}
page_size

int32

זה שינוי אופציונלי. מספר האזורים המקסימלי שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא צוין, יוחזרו 50 אזורים לכל היותר. הערך המקסימלי הוא 1,000. ערכים מעל 1,000 יועברו ל-1,000.
page_token

string

זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב-ListRegions. צריך לספק אותה כדי לאחזר את הדף הבא.

במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל-ListRegions חייבים להתאים לקריאה שסיפקה את אסימון הדף.

ListRegionsResponse

הודעת תשובה לשיטה ListRegions.

שדות
regions[]

Region

האזורים של המוכר שצוין.
next_page_token

string

אסימון, שניתן לשלוח בתור page_token כדי לאחזר את הדף הבא. אם השדה הזה יושמט, אין דפים נוספים.

ListSubAccountsRequest

בקשת הודעה ל-method ListSubAccounts.

שדות
provider

string

חובה. חשבון ההורה. פורמט: accounts/{account}
page_size

int32

זה שינוי אופציונלי. מספר החשבונות המקסימלי שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא צויין ערך, יוחזרו 250 חשבונות לכל היותר. הערך המקסימלי הוא 500. ערכים מעל 500 יועברו ל-500.
page_token

string

זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב-ListAccounts. צריך לספק אותה כדי לאחזר את הדף הבא.

במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל-ListAccounts חייבים להתאים לקריאה שסיפקה את אסימון הדף.

ListSubAccountsResponse

הודעת תשובה לשיטה ListSubAccounts.

שדות
accounts[]

Account

החשבונות שחשבון ההורה הרלוונטי משמש אותם כאתר אגרגטור.
next_page_token

string

אסימון, שניתן לשלוח בתור page_token כדי לאחזר את הדף הבא. אם השדה הזה יושמט, אין דפים נוספים.

ListUsersRequest

בקשת הודעה ל-method ListUsers.

שדות
parent

string

חובה. ההורה שהוא הבעלים של אוסף המשתמשים הזה. פורמט: `accounts/{account}
page_size

int32

זה שינוי אופציונלי. המספר המקסימלי של משתמשים שיחזרו. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא צויין ערך, יוחזרו 50 משתמשים לכל היותר. הערך המקסימלי הוא 100. ערכים מעל 100 יועברו ל-100
page_token

string

זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב-ListUsers. צריך לספק אותה כדי לאחזר את הדף הבא.

במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל-ListUsers חייבים להתאים לקריאה שסיפקה את אסימון הדף.

ListUsersResponse

הודעת תשובה לשיטה ListUsers.

שדות
users[]

User

המשתמשים מהחשבון שצוין.
next_page_token

string

אסימון, שניתן לשלוח בתור page_token כדי לאחזר את הדף הבא. אם השדה הזה יושמט, אין דפים נוספים.

LocationIdSet

רשימה של קבוצות של מזהי מיקומים. השדה לא יכול להיות ריק. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.

שדות
location_ids[]

string

חובה. רשימה של מזהי מיקומים שאינה ריקה. על כל המיקומים להיות מאותו סוג מיקום (לדוגמה, מדינה).

MinimumOrderValueTable

טבלה של ערכי ההזמנה המינימליים לכל חנות עבור סוג מילוי ההזמנות לאיסוף.

שדות
store_code_set_with_movs[]

StoreCodeSetWithMov

חובה. רשימה של קבוצות של קודי חנויות שיש להן ערך הזמנה מינימלי (MOV) זהה. צריך להזין לפחות שתי קבוצות והשנייה צריכה להיות ריקה, כדי לציין 'MOV לכל שאר החנויות'. כל קוד חנות יכול להופיע פעם אחת בלבד בכל הקבוצות. לכל המחירים בשירות מסוים צריך להיות מטבע זהה.

StoreCodeSetWithMov

רשימה של קבוצות של קודי חנויות שיש להן ערך הזמנה מינימלי זהה. צריך להזין לפחות שתי קבוצות והשנייה צריכה להיות ריקה, כדי לציין 'MOV לכל שאר החנויות'. כל קוד חנות יכול להופיע פעם אחת בלבד בכל הקבוצות. לכל המחירים בשירות מסוים צריך להיות מטבע זהה.

שדות
store_codes[]

string

זה שינוי אופציונלי. רשימה של קודי חנויות ייחודיים, או ריקה להכול.
value

Price

ערך ההזמנה המינימלי בחנויות הנתונות.

OnlineReturnPolicy

אובייקט Online return policy (מדיניות החזרת מוצרים אונליין). ההגדרה הזו משמשת כרגע לייצוג מדיניות החזרת מוצרים של מודעות ותוכניות של כרטיסי מוצר חינמיים.

שדות
name

string

מזהה. שם המשאב OnlineReturnPolicy. פורמט: accounts/{account}/onlineReturnPolicies/{return_policy}
return_policy_id

string

פלט בלבד. מזהה מדיניות החזרת המוצרים שנוצר על ידי Google.
label

string

השדה הזה מייצג את התווית הייחודית שהוגדרה על ידי המשתמש של מדיניות החזרת המוצרים. חשוב לציין שאי אפשר להשתמש באותה תווית במדיניות החזרת מוצרים שונה לאותה מדינה. המדיניות תסומן באופן אוטומטי בתווית 'ברירת המחדל', אלא אם למוצר צוין מאפיין ספציפי של תווית. כדי להקצות מדיניות החזרת מוצרים מותאמת אישית לקבוצות מוצרים מסוימות, צריך לפעול לפי ההוראות שמפורטות בתווית של מדיניות החזרת מוצרים. התווית יכולה להכיל עד 50 תווים.
countries[]

string

מדינות המכירה שבהן חלה מדיניות החזרת המוצרים. הערכים חייבים להיות קוד ISO 3166 חוקי בן 2 אותיות.
policy

Policy

מדיניות החזרת המוצרים.
restocking_fee

RestockingFee

עמלת החזרה למלאי שחלה על כל הקטגוריות של סיבות ההחזרה. אם הערך לא הוגדר, זה ייחשב כעמלת החזרה למלאי בחינם.
return_methods[]

ReturnMethod

מהן שיטות ההחזרה שבהן לקוחות יכולים להחזיר פריט. חובה להשאיר את הערך הזה ריק, אלא אם הסוג של מדיניות החזרת המוצרים הוא noReturns.
item_conditions[]

ItemCondition

חובה למלא את תנאי הפריט שבהם אפשר להחזיר מוצרים, אלא אם סוג מדיניות החזרת המוצרים הוא 'noReturns'.
return_shipping_fee

ReturnShippingFee

דמי המשלוח להחזרת מוצר. יש להגדיר אותה רק כשהלקוח צריך להוריד ולהדפיס את תווית ההחזרה.
return_policy_uri

string

ה-URI של מדיניות החזרת המוצרים Google יכולה להשתמש בתכונה הזו כדי לבצע בדיקת שפיות למדיניות. חייבת להיות כתובת URL חוקית.
accept_defective_only

bool

השדה הזה מציין אם המוכר מקבל רק מוצרים פגומים להחזרת מוצרים, והשדה הזה הוא חובה.
process_refund_days

int32

השדה מציין את מספר הימים שנדרשים למוכרים כדי לעבד החזרים כספיים. השדה הוא אופציונלי.
accept_exchange

bool

השדה הזה מציין אם המוכר מאפשר ללקוחות להחליף מוצרים, השדה הזה הוא חובה.

ItemCondition

תנאי הפריטים הזמינים.

טיפוסים בני מנייה (enum)
ITEM_CONDITION_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
NEW חדש.
USED בשימוש.

מדיניות

כללי המדיניות הזמינים.

שדות
type

Type

סוג המדיניות.
days

int64

מספר הימים שאפשר להחזיר פריטים אחרי המסירה. יום אחד מוגדר כ-24 שעות אחרי חותמת הזמן של המסירה. נדרש עבור החזרות של NUMBER_OF_DAYS_AFTER_DELIVERY.

סוג

הסוגים של מדיניות החזרת המוצרים.

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
NUMBER_OF_DAYS_AFTER_DELIVERY מספר הימים שבהם ההחזרה תקפה מרגע המסירה.
NO_RETURNS אין אפשרות להחזיר מוצרים.
LIFETIME_RETURNS וזה לא הכול!

RestockingFee

עמלת החזרה למלאי. זה יכול להיות סכום קבוע או מיקרו-אחוז.

שדות

שדה איחוד type.

type יכול להיות רק אחת מהאפשרויות הבאות:
fixed_fee

Price

עמלת החזרה למלאי קבועה.
micro_percent

int32

אחוז מהמחיר הכולל במיליוניות השנייה. 15,000,000 פירושו שיחויבו 15% מהמחיר הכולל.

ReturnMethod

השיטות הזמינות להחזרת מוצרים.

טיפוסים בני מנייה (enum)
RETURN_METHOD_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
BY_MAIL החזרה בדואר.
IN_STORE יש לחזור בחנות.
AT_A_KIOSK החזרה בקיוסק.

ReturnShippingFee

דמי המשלוח להחזרת מוצר. התשלום יכול להיות עמלה קבועה או בוליאני, כדי לציין שהלקוח משלם את עלות המשלוח בפועל.

שדות
type

Type

סוג עמלת המשלוח להחזרת מוצר.
fixed_fee

Price

סכום קבוע של עמלת משלוח להחזרת מוצר. הערך הזה רלוונטי רק כשהסוג הוא FIXED. אנחנו נתייחס לדמי המשלוח להחזרת מוצר כבחינם אם הסוג הוא FIXED ולא הוגדר ערך.

סוג

סוגי דמי משלוח להחזרת מוצרים.

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
FIXED דמי המשלוח להחזרת מוצר הם ערך קבוע.
CUSTOMER_PAYING_ACTUAL_FEE הלקוחות ישלמו את דמי המשלוח בפועל להחזרת המוצר.

PhoneVerificationState

מצב האימות של מספר הטלפון.

טיפוסים בני מנייה (enum)
PHONE_VERIFICATION_STATE_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
PHONE_VERIFICATION_STATE_VERIFIED מספר הטלפון מאומת.
PHONE_VERIFICATION_STATE_UNVERIFIED הטלפון לא מאומת

תוכנית

מגדיר את ההשתתפות בתוכנית נתונה של החשבון שצוין.

התוכניות מספקות מנגנון להוספת פונקציונליות לחשבונות המוכרים. דוגמה אופיינית לכך היא התוכנית כרטיסי מוצר חינמיים, שמאפשרת להציג ב-Google בחינם מוצרים מחנות של מוֹכר.

שדות
name

string

מזהה. שם המשאב של התוכנה. פורמט: accounts/{account}/programs/{program}
documentation_uri

string

פלט בלבד. כתובת ה-URL של דף עזרה ב-Merchant Center שמתאר את התוכנית.
state

State

פלט בלבד. סטטוס ההשתתפות של החשבון בתוכנית.
active_region_codes[]

string

פלט בלבד. האזורים שבהם החשבון משתתף באופן פעיל בתוכנית. אזורים פעילים מוגדרים כאזורים שבהם מתקיימים כל דרישות התוכנית שמשפיעות על האזורים.

קודי האזורים מוגדרים באמצעות CLDR. במדינה הזו התוכנית חלה באופן ספציפי על מדינה זו או על 001 אם התוכנית חלה בכל העולם.
unmet_requirements[]

Requirement

פלט בלבד. הדרישות שהחשבון עדיין לא עמד בהן ומשפיעות על ההשתתפות בתוכנית.

דרישה

מגדיר דרישה שצוינה להשתתפות בתוכנית.

שדות
title

string

פלט בלבד. שם הדרישה.
documentation_uri

string

פלט בלבד. כתובת ה-URL של דף עזרה שמתאר את הדרישה.
affected_region_codes[]

string

פלט בלבד. האזורים שמושפעים כרגע מהדרישה הזו לא מתקיימים.

קודי האזורים מוגדרים באמצעות CLDR. במדינה הזו התוכנית חלה באופן ספציפי על מדינה זו או על 001 אם התוכנית חלה בכל העולם.

ארץ

מצבים אפשריים להשתתפות בתוכנית של החשבון.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
NOT_ELIGIBLE החשבון לא עומד בדרישות ההשתתפות בתוכנית.
ELIGIBLE החשבון עומד בדרישות להשתתפות בתוכנית.
ENABLED התוכנית מופעלת עבור החשבון.

RateGroup

הגדרות של קבוצת תעריפי משלוחים. רק התג האחרון יכול להכיל applicable_shipping_labels ריק, כלומר 'כל השאר'. הערכים מסוג 'applicable_shipping_labels' האחרים לא יכולים לחפוף.

שדות
applicable_shipping_labels[]

string

חובה. רשימה של תוויות משלוח שמגדירות את המוצרים שעליהם חלה קבוצת התעריפים הזו. זהו הבדל: רק אחת מהתוויות צריכה להתאים כדי שקבוצת התעריפים תחול. השדה הזה יכול להיות ריק רק לקבוצת התעריפים האחרונה של שירות.
subtables[]

Table

זה שינוי אופציונלי. רשימה של טבלאות משנה שיש להן הפניה אל main_table. אפשר להגדיר את הערך הזה רק אם השדה main_table מוגדר.
carrier_rates[]

CarrierRate

זה שינוי אופציונלי. רשימה של תעריפים של חברות תובלה שאפשר להתייחס אליהם לפי main_table או single_value.
single_value

Value

הערך של קבוצת התעריפים (למשל, תעריף קבוע של 40 ש"ח). אפשר להגדיר רק אם המדיניות main_table ו-subtables לא מוגדרות.
main_table

Table

טבלה שמגדירה את קבוצת התעריפים, במקרים שבהם הביטוי single_value לא מספיק מפורש. אפשר להגדיר את הערך רק אם השדה single_value לא מוגדר.
name

string

זה שינוי אופציונלי. השם של קבוצת התעריפים. אם מוגדר ערך ייחודי בשירות המשלוחים.

אזור

מייצג אזור גיאוגרפי שאפשר להשתמש בו כיעד גם בשירות RegionalInventory וגם בשירות ShippingSettings. אפשר להגדיר אזורים כאוספים של מספרי מיקוד, או במדינות מסוימות באמצעות טירגוטים גיאוגרפיים מוגדרים מראש. מידע נוסף זמין במאמר הגדרת אזורים .

שדות
name

string

מזהה. שם המשאב של האזור. פורמט: accounts/{account}/regions/{region}
postal_code_area

PostalCodeArea

זה שינוי אופציונלי. רשימת מיקודים שמגדירה את אזור האזור.
geotarget_area

GeoTargetArea

זה שינוי אופציונלי. רשימה של יעדים גיאוגרפיים שמגדירים את אזור האזור.
regional_inventory_eligible

BoolValue

פלט בלבד. שדה זה מציין אם האזור עומד בדרישות לשימוש בהגדרת המלאי האזורי.
shipping_eligible

BoolValue

פלט בלבד. שדה זה מציין אם האזור עומד בדרישות לשימוש בהגדרת שירותי המשלוחים.
display_name

string

זה שינוי אופציונלי. השם המוצג של האזור.

GeoTargetArea

רשימה של יעדים גיאוגרפיים שמגדירים את אזור האזור.

שדות
geotarget_criteria_ids[]

int64

חובה. רשימה של מזהי מיקומים שאינה ריקה. על כל המיקומים להיות מאותו סוג מיקום (לדוגמה, מדינה).

PostalCodeArea

רשימת מיקודים שמגדירה את אזור האזור. הערה: אפשר לגשת לכל האזורים שהוגדרו באמצעות מספרי מיקוד דרך המשאב ShippingSettings.postalCodeGroups של החשבון.

שדות
region_code

string

חובה. קוד האזור במאגר CLDR או המדינה שעליה חלה קבוצת המיקוד.
postal_codes[]

PostalCodeRange

חובה. טווח של מספרי מיקוד.

PostalCodeRange

טווח של מספרי מיקוד שמגדיר את אזור האזור.

שדות
begin

string

חובה. מיקוד או תבנית של קידומת הטופס* שמציין את הגבול התחתון הכולל של הטווח שמגדיר את האזור. ערכים לדוגמה: 94108, 9410*, 9*.
end

string

זה שינוי אופציונלי. מיקוד או תבנית בצורה prefix* שמציינת את הגבול העליון הכולל של הטווח שמגדיר את האזור. האורך שלו צריך להיות זהה לזה של zipCodeRangeBegin: אם מיקוד CodeRangeBegin הוא מיקוד, אז גםPostalCodeRangeEnd חייב להיות מיקוד. אם המיקוד CodeRangeBegin הוא דפוס מסוים, המיקוד חייב להיות בדפוס עם אותו אורך קידומת. אופציונלי: אם המדיניות לא מוגדרת, האזור מוגדר ככל מספרי המיקוד שתואמים ל-PostalCodeRangeBegin.

נדרש

תיאור התנאים וההגבלות הנדרשים לאישור.

שדות
terms_of_service

string

את termsOfService שיש לאשר.
tos_file_uri

string

כתובת ה-URL המלאה של קובץ התנאים וההגבלות. השדה הזה זהה לשדה TermsOfService.file_uri, הוא מתווסף כאן מטעמי נוחות בלבד.

RetrieveForApplicationTermsOfServiceAgreementStateRequest

בקשת הודעה ל-method RetrieveForApplicationTermsOfServiceAgreementState.

שדות
parent

string

חובה. החשבון שעבורו מקבלים את הפורמט של התנאים וההגבלות הסכם מצב: accounts/{account}

RetrieveLatestTermsOfServiceRequest

בקשת הודעה ל-method RetrieveLatestTermsOfService.

שדות
region_code

string

קוד האזור לפי ההגדרה של CLDR. מדובר במדינה שבה התנאים וההגבלות חלים באופן ספציפי על אותה מדינה, או אם התנאים וההגבלות חלים בכל העולם, או קוד 001.
kind

TermsOfServiceKind

סוג הגרסה של התנאים וההגבלות האלה.

שורה

מוסיפים רשימת תאים.

שדות
cells[]

Value

חובה. רשימת התאים שמרכיבים את השורה. האורך של הטבלה צריך להיות זהה לזה של columnHeaders בטבלאות דו-ממדיות, והאורך של טבלאות חד-ממדיות יהיה 1.

שירות

שירות משלוחים.

שדות
delivery_countries[]

string

חובה. קוד הטריטוריה של מאגר ה-CLDR של המדינות שבהן השירות חל.
rate_groups[]

RateGroup

זה שינוי אופציונלי. הגדרות של קבוצת תעריפי משלוחים. רק התג האחרון יכול להכיל applicable_shipping_labels ריק, כלומר 'כל השאר'. הערכים מסוג 'applicable_shipping_labels' האחרים לא יכולים לחפוף.
loyalty_programs[]

LoyaltyProgram

זה שינוי אופציונלי. מועדוני לקוחות ששירות המשלוחים הזה מוגבל אליהם.
service_name

string

חובה. שם השירות שמופיע בניסוח חופשי. חייב להיות ייחודי בחשבון היעד.
active

bool

חובה. ערך בוליאני שחושף את הסטטוס הפעיל של שירות המשלוחים.
currency_code

string

קוד ה-CLDR של המטבע שעליו השירות הזה חל. הערך חייב להיות זהה למחירים בקבוצות התעריפים.
delivery_time

DeliveryTime

חובה. הזמן שהוקדש להיבטים שונים, מרגע קבלת המוצר ועד למסירת המוצר.
shipment_type

ShipmentType

סוג המיקומים שאליהם השירות הזה מבצע הזמנות.
minimum_order_value

Price

ערך הזמנה מינימלי לשירות הזה. אם המדיניות מוגדרת, המשמעות היא שהלקוחות יצטרכו להוציא לפחות סכום זה. לכל המחירים בשירות מסוים צריך להיות מטבע זהה. לא ניתן להגדיר יחד עם ערך מינימלי_order_value_table.
minimum_order_value_table

MinimumOrderValueTable

טבלה של ערכי ההזמנה המינימליים לכל חנות עבור סוג מילוי ההזמנות לאיסוף. לא ניתן להגדיר יחד עם ערך מינימלי_order_value.
store_config

StoreConfig

רשימה של החנויות שמהן נשלחים המוצרים. תקף רק לסוג משלוח מקומי.

LoyaltyProgram

מועדון לקוחות שסופק על ידי מוכר.

שדות
loyalty_program_tiers[]

LoyaltyProgramTiers

זה שינוי אופציונלי. רמת מועדון הלקוחות של שירות המשלוחים הזה.
program_label

string

תווית מועדון הלקוחות שנוצרה בהגדרות של מועדון הלקוחות ב-Merchant Center. מאפיין המשנה הזה מאפשר ל-Google למפות את מועדון הלקוחות למוצרים כשירים.

LoyaltyProgramTiers

קבוצת משנה של מועדון לקוחות של מוכר.

שדות
tier_label

string

מאפיין המשנה לתווית הרמה [tier_label] יוצר הבדל בין הטבות ברמת המוצר ברמות שונות. הערך הזה מוגדר גם בהגדרות התוכנית ב-Merchant Center, והוא נדרש לשינויים במקור הנתונים גם אם במועדון הלקוחות שלכם יש רק רמה אחת.

ShipmentType

סוג שירות המשלוחים.

טיפוסים בני מנייה (enum)
SHIPMENT_TYPE_UNSPECIFIED בשירות הזה לא צוין סוג משלוח.
DELIVERY בשירות הזה אפשר לשלוח הזמנות לכתובת שהלקוח בחר.
LOCAL_DELIVERY בשירות הזה אפשר לשלוח הזמנות לכתובת שהלקוח בחר. ההזמנה נשלחת מחנות מקומית בקרבת מקום.
COLLECTION_POINT בשירות הזה אפשר לשלוח הזמנות לכתובת שהלקוח בחר. ההזמנה נשלחת מנקודת איסוף.

StoreConfig

רשימה של החנויות שמהן נשלחים המוצרים. תקף רק לסוג משלוח מקומי.

שדות
store_codes[]

string

זה שינוי אופציונלי. רשימה של קודי חנויות שמספקים משלוח מקומי. אם השדה ריק, הערך all_stores חייב להיות True.
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 ימים. לדוגמה, אם בשירות המשלוחים מוגדר מסירה ביום הקנייה ומועד הסיום חלף, אם הערך בשדה הזה הוא true, תעריף שירות המשלוחים המחושב יהיה NO_DELIVERY_POST_CUTOFF. באותה דוגמה, אם מגדירים בשדה הזה את הערך false, זמן המשלוח המחושב הוא יום אחד. האפשרות הזאת מיועדת למשלוח מקומי בלבד.

LocalCutoffTime

השעה שבה המשלוח המקומי מסתיים באותו יום.

שדות
hour

int64

אפשר לבצע הזמנות עם משלוח מקומי לפי שעה עד לסיום הטיפול באותו יום.
minute

int64

הזמנות של משלוח מקומי לפי דקות חייבות להתבצע עד לאותו יום.

StoreServiceType

מציין אם כל החנויות או החנויות הנבחרות שצוינו על ידי המוכר מספקות משלוח מקומי.

טיפוסים בני מנייה (enum)
STORE_SERVICE_TYPE_UNSPECIFIED לא צוין סוג שירות החנות.
ALL_STORES שדה זה מציין אם כל החנויות – הקיימות והעתידיות – שמספקות משלוח מקומי.
SELECTED_STORES מציין שרק החנויות שמופיעות בstore_codes עומדות בדרישות למשלוח מקומי.

ShippingSettings

[הגדרת המשלוח]((https://support.google.com/merchants/answer/6069284) של חשבון המוכר/ת.

שדות
name

string

מזהה. שם המשאב של הגדרת המשלוח. פורמט: accounts/{account}/shippingSetting
services[]

Service

זה שינוי אופציונלי. רשימת השירותים של חשבון היעד.
warehouses[]

Warehouse

זה שינוי אופציונלי. רשימה של מחסנים שאפשר להתייחס אליהם ב-services.
etag

string

חובה. השדה הזה משמש למניעת בעיה אסינכרונית. צריך לוודא שנתוני הגדרות המשלוח לא השתנו בין קבלת שיחה להוספת שיחה. המשתמש צריך לבצע את השלבים הבאים:

  1. צריך להגדיר את שדה ה-ETag כמחרוזת ריקה ליצירה ראשונית של הגדרת משלוח.

  2. אחרי היצירה הראשונית, צריך להפעיל את שיטת get get כדי לקבל את ה-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

הכותרות של עמודות הטבלה. אופציונלי: אם היא לא מוגדרת, יש לטבלה מאפיין אחד בלבד.

TaxRule

סוג ההמרה הראשי

אחוז מיקרו : 100% = 1 000 000 ו-1% = 10 000 לא יכול להיות שלילי.

מידע על זיקה לצורכי מס ופרמטרים קשורים שרלוונטיים להזמנות שנמסרו לאזור שמכוסה על ידי אדמין מס אחד. מכשיר Nexus נוצר כשמוכר מבצע עסקים באזור שמנוהל על ידי מנהל המס (אפשר להגדיר זיקה לצורכי מס רק למדינות בארה"ב). אם למוכר יש זיקה במדינה בארה"ב, המוכר צריך לשלם מס לכל רשויות המס שקשורות ליעד המשלוח. המזהה הבא : 8

שדות
region_code

string

קוד האזור שבו הכלל הזה חל
shipping_taxed

bool

אם המדיניות מוגדרת, המערכת תגבה מס על המשלוח (בשיעור זהה לתעריף של המוצר) כשמסירים מוצרים לאזור של האדמין. אפשר להגדיר את הערך רק במדינות בארה"ב ללא קטגוריה.
effective_time_period

Interval

חובה. התקופה שבה הכלל ייכנס לתוקף. אם משך הזמן לא רשום ב-Effective_time, אז הוא פתוח עם סיום בעתיד. ההתחלה של התקופה הזו כוללת, והיא לא כוללת את הסיום.
שדה איחוד location. יש לתאר את המיקום באמצעות טווח מיקוד או מזהה קריטריון. location יכול להיות רק אחת מהאפשרויות הבאות:
location_id

int64

הערך admin_id או criteria_id של האזור שבו הכלל הזה חל.
post_code_range

TaxPostalCodeRange

טווח מספרי המיקוד שבהם הכלל הזה חל.
שדה איחוד rate_calculation. מהי הדרך שבה מחשבים את שיעור המס על משלוחים לאזור של האדמין הזה. אפשר להגדיר זאת רק במדינות בארה"ב. rate_calculation יכול להיות רק אחת מהאפשרויות הבאות:
use_google_rate

bool

תעריף שתלוי במיקום המשלוח: אם למוכר יש זיקה לצורכי מס במדינה תואמת בארה"ב, יתווספו תעריפים מרשויות שיש להן סמכות שיפוט מעל האזור למשלוחים.
self_specified_rate_micros

int64

תעריף קבוע שמצוין במיליוניות השנייה, כאשר 100% = 1_000_000. מתאים למדינות לפי המוצא.

TaxPostalCodeRange

טווח של מספרי מיקוד שמגדיר את האזור.

שדות
start

string

חובה. תחילת טווח המיקוד, שהוא גם הקטן ביותר בטווח.
end

string

סוף טווח המיקודים. אם לא תציינו ערך, תהיה אותה ערך כמו 'התחלה'.

TermsOfService

TermsOfService.

שדות
name

string

מזהה. שם המשאב של גרסת התנאים וההגבלות. פורמט: termsOfService/{version}
region_code

string

קוד האזור לפי ההגדרה של CLDR. מדובר במדינה שבה התנאים וההגבלות חלים באופן ספציפי על אותה מדינה, או 001 אם אפשר לחתום על אותו TermsOfService בכל מדינה. עם זאת, חשוב לזכור שכשחותמים על התנאים וההגבלות שחלים בכל העולם, אנחנו עדיין מצפים שמדינה ספציפית תצוין (המדינה הזו צריכה להיות המדינה שבה העסק פועל של המוכר או המדינה שבה פועלת התוכנית).
kind

TermsOfServiceKind

סוג הגרסה של התנאים וההגבלות האלה.
external

bool

אם הגרסה הזו של התנאים וההגבלות היא חיצונית. אפשר לאשר גרסאות חיצוניות של תנאים והגבלות רק בתהליכים חיצוניים, ולא ישירות על ידי המוכר דרך ממשק משתמש או API.
file_uri

string

URI לקובץ התנאים וההגבלות שצריך להציג כדי לחתום על משתמשים.

TermsOfServiceAgreementState

המשאב הזה מייצג את מצב ההסכם של חשבון מסוים ואת סוג התנאים וההגבלות. המדינה צריכה להיות:

  • אם המוכר אישר את התנאים וההגבלות: השדה מאושר יאוכלס. אחרת, השדה יהיה ריק.
  • אם המוכר חייב לחתום על תנאים והגבלות: שדה חובה יאוכלס. אחרת, השדה יהיה ריק.

הערה: אפשר לכלול גם את שדה חובה וגם את מאושר. במקרה כזה, תאריך התפוגה של התנאים וההגבלות של accepted יוגדר בשדה valid_until. עליך לאשר את התנאים וההגבלות של required לפני valid_until כדי שהחשבון ימשיך להיות בעל הסכם תקף. כשאנחנו מקבלים תנאים והגבלות חדשים, אנחנו מצפים מצדדים שלישיים להציג את הטקסט שמשויך להסכם התנאים וההגבלות הנתון (כתובת ה-URL לקובץ שמכיל את הטקסט תתווסף בהודעה הנדרשת שבהמשך כ-tos_file_uri. כדי לאשר בפועל את התנאים וההגבלות, צריך להפעיל את ההגדרה 'אישור' במשאב TermsOfService.

שדות
name

string

מזהה. שם המשאב של גרסת התנאים וההגבלות. פורמט: accounts/{account}/termsOfServiceAgreementState/{identifier}
region_code

string

קוד האזור כפי שמוגדר על ידי https://cldr.unicode.org/. זוהי המדינה שעליה חלה המדינה הנוכחית.
terms_of_service_kind

TermsOfServiceKind

סוג התנאים וההגבלות המשויכים לגרסה המסוימת.
accepted

Accepted

התנאים וההגבלות הקבילים מהסוג הזה ובקוד האזור המשויך
required

Required

התנאים וההגבלות הנדרשים

TermsOfServiceKind

תנאי השירות.

טיפוסים בני מנייה (enum)
TERMS_OF_SERVICE_KIND_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
MERCHANT_CENTER אפליקציית Merchant Center.

TransitTable

טבלת זמן הובלה, מספר ימי העסקים שהובלה על סמך מאפייני שורה ועמודה. אפשר להגדיר min_transit_days, max_transit_days או transit_time_table, אבל לא את שתיהן.

שדות
postal_code_group_names[]

string

חובה. רשימה של שמות האזורים Region.name . הערך האחרון יכול להיות "all other locations". לדוגמה: ["zone 1", "zone 2", "all other locations"]. קבוצות המיקוד שאליהן מתבצעת הפניה צריכות להתאים למדינה שבה השירות זמין.
transit_time_labels[]

string

חובה. רשימה של תוויות זמן הובלה. הערך האחרון יכול להיות "all other labels". לדוגמה: ["food", "electronics", "all other labels"].
rows[]

TransitTimeRow

חובה. אם קיימת רק קבוצת מאפיינים אחת של postal_code_group_names או transit_time_labels, יש מספר שורות שכל אחת מהן מכילה ערך אחד עבור המאפיין הזה. אם יש שני מאפיינים, כל שורה תואמת למאפיין postal_code_group_names, והעמודות (ערכים) תואמות למאפיין transit_time_labels.

TransitTimeRow

אם קיימת רק קבוצת מאפיינים אחת של postal_code_group_names או transit_time_labels, יש מספר שורות שכל אחת מהן מכילה ערך אחד עבור המאפיין הזה. אם יש שני מאפיינים, כל שורה תואמת למאפיין postal_code_group_names, והעמודות (ערכים) תואמות למאפיין transit_time_labels.

שדות
values[]

TransitTimeValue

חובה. טווח זמן ההובלה (מינימום) בימי עסקים.

TransitTimeValue

טווח זמן ההובלה (מינימום) בימי עסקים.

שדות
min_transit_days

int32

טווח זמן ההובלה המינימלי בימי עסקים. 0 פירושו מסירה ביום הקנייה, 1 פירושו משלוח ביום המחרת.
max_transit_days

int32

חייב להיות גדול מ-min_transit_days או שווה לו.

UnclaimHomepageRequest

בקשת הודעה ל-method UnclaimHomepage.

שדות
name

string

חובה. שם דף הבית שרוצים לבטל את תביעת הבעלות עליו. פורמט: accounts/{account}/homepage

UpdateAccountRequest

בקשת הודעה ל-method UpdateAccount.

שדות
account

Account

חובה. הגרסה החדשה של החשבון.
update_mask

FieldMask

חובה. רשימת השדות שצריך לעדכן.

UpdateAccountTaxRequest

שליחת בקשה לעדכון הגדרות המס

שדות
account_tax

AccountTax

חובה. הגדרת המס שתעודכן
update_mask

FieldMask

רשימת השדות לעדכון

UpdateBusinessIdentityRequest

בקשת הודעה ל-method UpdateBusinessIdentity.

שדות
business_identity

BusinessIdentity

חובה. הגרסה החדשה של זהות העסק.
update_mask

FieldMask

חובה. רשימת השדות שצריך לעדכן.

UpdateBusinessInfoRequest

בקשת הודעה ל-method UpdateBusinessInfo.

שדות
business_info

BusinessInfo

חובה. הגרסה החדשה של פרטי העסק.
update_mask

FieldMask

חובה. רשימת השדות שצריך לעדכן.

UpdateEmailPreferencesRequest

בקשת הודעה לשיטת UpdateEmailPreferences.

שדות
email_preferences

EmailPreferences

חובה. העדפות האימייל לעדכון.
update_mask

FieldMask

חובה. רשימת השדות שצריך לעדכן.

UpdateHomepageRequest

בקשת הודעה ל-method UpdateHomepage.

שדות
homepage

Homepage

חובה. הגרסה החדשה של דף הבית.
update_mask

FieldMask

חובה. רשימת השדות שצריך לעדכן.

UpdateRegionRequest

בקשת הודעה ל-method UpdateRegion.

שדות
region

Region

חובה. האזור המעודכן.
update_mask

FieldMask

זה שינוי אופציונלי. מסכת שדות שמופרדים בפסיקים שמציינת את השדות שצריך לעדכן. דוגמה: "displayName,postalCodeArea.regionCode"

UpdateUserRequest

בקשת הודעה ל-method UpdateUser.

שדות
user

User

חובה. הגרסה החדשה של המשתמש.

אפשר גם לעדכן את המשתמש התואם למתקשר על ידי שימוש ב-me במקום בכתובת אימייל בשדה השם כמו ב-accounts/{account}/users/me.
update_mask

FieldMask

חובה. רשימת השדות שצריך לעדכן.

משתמש

משתמש.

שדות
name

string

מזהה. שם המשאב של המשתמש. פורמט: accounts/{account}/user/{user}
state

State

פלט בלבד. המצב של המשתמש.
access_rights[]

AccessRight

זה שינוי אופציונלי. הרשאות הגישה שיש למשתמש.

ארץ

המצבים האפשריים של המשתמש.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
PENDING המשתמש ממתין לאישור. במצב הזה, המשתמש צריך קודם לאשר את ההזמנה לפני שהוא מבצע פעולות אחרות.
VERIFIED המשתמש מאומת.

ערך של Gpa education

הערך היחיד של קבוצת תעריפים או הערך של התא בטבלת קבוצת תעריפים. יש להגדיר רק אחד מהערכים no_shipping, flat_rate, price_percentage, carrier_rateName, subtable_name.

שדות
no_shipping

bool

אם הערך הוא True, לא ניתן לשלוח את המוצר. הערך צריך להיות True כשמגדירים, רק אם לא מוגדרים כל שאר השדות.
flat_rate

Price

תעריף קבוע. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.
price_percentage

string

אחוז מהמחיר שמיוצג כמספר בסימון העשרוני (לדוגמה, "5.4"). ניתן להגדיר אותו רק אם לא הוגדרו כל השדות האחרים.
carrier_rate

string

השם של תעריף של חברת תובלה שמתייחס לתעריף של חברת תובלה שמוגדר באותה קבוצת תעריפים. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.
subtable

string

השם של טבלת משנה. אפשר להגדיר אותן רק בתאים בטבלה (לדוגמה לא לערכים בודדים) ורק אם כל שאר השדות לא הוגדרו.

מחסן

מחסן לאספקה, שבו מאחסנים ומטפלים במלאי. התג הבא: 7

שדות
name

string

חובה. שם המחסן. חייב להיות ייחודי בחשבון.
shipping_address

Address

חובה. הכתובת למשלוח של המחסן.
cutoff_time

WarehouseCutoffTime

חובה. השעה האחרונה ביום שבה אפשר לאשר את ההזמנה ולהתחיל לעבד אותה. הזמנות שיבוצעו מאוחר יותר יטופלו ביום הבא. השעה מבוססת על המיקוד של המחסן.
handling_days

int64

חובה. מספר הימים שנדרשים למחסן הזה כדי לארוז ולשלוח פריט. מגדירים את המאפיין הזה ברמת המחסן, אבל אפשר לשנות אותו ברמת המוצר בהתאם למאפיינים של הפריט.
business_day_config

BusinessDayConfig

ימי העסקים במחסן. אם לא מגדירים את הערך, ברירת המחדל תהיה שני עד שישי.

WarehouseBasedDeliveryTime

מציין שיש לחשב את זמן האספקה לכל מחסן (מיקום המוצא של המשלוח) על סמך ההגדרות של חברת התובלה שנבחרה. כשההגדרה הזו מוגדרת, לא צריך להגדיר שדה אחר שקשור לזמן הובלה ב-delivery_time.

שדות
carrier

string

חובה. ספק, למשל "UPS" או "Fedex".
carrier_service

string

חובה. השירות של ספק הסלולר, למשל "ground" או "2 days". שם השירות חייב להופיע ברשימה eddSupportedServices.
warehouse

string

חובה. שם המחסן. הוא צריך להיות תואם לערך [warehouse][ShippingSetting.warehouses.name]

WarehouseCutoffTime

השעה האחרונה ביום שבה אפשר לאשר את ההזמנה ולהתחיל לעבד אותה. הזמנות שיבוצעו מאוחר יותר יטופלו ביום הבא. השעה מבוססת על המיקוד של המחסן.

שדות
hour

int32

חובה. השעה המאוחרת ביותר שבה צריך לבצע הזמנה כדי שהיא תעובד במחסן באותו יום. השעה מבוססת על אזור הזמן של המחסן.
minute

int32

חובה. דקה של המועד האחרון להזמנה כדי שההזמנה תעובד באותו יום במחסן. הדקות מבוססות על אזור הזמן של המחסן.