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.

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

היקפי הרשאה

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

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

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

rpc GetAccount(GetAccountRequest) returns (Account)

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

היקפי הרשאה

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

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

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

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

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

היקפי הרשאה

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

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

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

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

הצגת רשימה של כל חשבונות המשנה של חשבון מרובה לקוחות נתון. זוהי חבילה נוחה לשיטה החזקה יותר ListAccounts. השיטה הזו תניב את אותן תוצאות כמו קריאה ל-ListsAccounts עם המסנן הבא: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

היקפי הרשאה

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

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

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

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

עדכון חשבון ללא קשר לסוג שלו: חשבון עצמאי, חשבון MCA או חשבון משנה. כדי להריץ את השיטה הזו נדרשת הרשאת אדמין.

היקפי הרשאה

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

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

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

AutofeedSettingsService

שירות שתומך בהגדרה פיד אוטומטי.

GetAutofeedSettings

rpc GetAutofeedSettings(GetAutofeedSettingsRequest) returns (AutofeedSettings)

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

היקפי הרשאה

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

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

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

rpc UpdateAutofeedSettings(UpdateAutofeedSettingsRequest) returns (AutofeedSettings)

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

היקפי הרשאה

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

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

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

BusinessIdentityService

שירות שתומך ב-API של זהות עסקית.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

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

היקפי הרשאה

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

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

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

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

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

היקפי הרשאה

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

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

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

BusinessInfoService

שירות לתמיכה ב-API של פרטי העסק.

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

אחזור פרטי העסק של חשבון.

היקפי הרשאה

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

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

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

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

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

היקפי הרשאה

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

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

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

EmailPreferencesService

שירות שתומך ב-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_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.
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

שירות שמקבל מידע על הגדרות המשלוח של קריאת method לכל method של 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. כדי להריץ את השיטה הזו נדרשת הרשאת אדמין. המשתמש שרוצים למחוק לא יכול להיות המשתמש האחרון עם הרשאת אדמין בחשבון. בנוסף, משתמש מוגן מפני מחיקה אם הוא מנוהל על ידי Business Manager"

היקפי הרשאה

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

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

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

rpc GetUser(GetUserRequest) returns (User)

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

היקפי הרשאה

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

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

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

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

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

היקפי הרשאה

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

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

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

rpc UpdateUser(UpdateUserRequest) returns (User)

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

היקפי הרשאה

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

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

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

AcceptTermsOfServiceRequest

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

שדות
name

string

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

string

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

string

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

אושרו

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

שדות
terms_of_service

string

termsOfService שאושרו.
accepted_by

string

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

Date

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

AccessRight

הרשאת הגישה.

טיפוסים בני מנייה (enum)
ACCESS_RIGHT_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
STANDARD הרשאות גישה רגילות.
ADMIN הרשאות גישה של אדמין.
PERFORMANCE_REPORTING משתמשים עם ההרשאה הזו יכולים לגשת לנתוני הביצועים ולתובנות.

חשבון

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

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

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

ההודעה Account היא הישות ההורה של משאבים רבים אחרים, למשל AccountRelationship,‏ Homepage,‏ BusinessInfo וכו'.

שדות
name

string

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

int64

פלט בלבד. המזהה של החשבון.
account_name

string

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

bool

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

bool

פלט בלבד. האם זהו חשבון בדיקה.
time_zone

TimeZone

חובה. אזור הזמן של החשבון.

בכתיבה, time_zone מגדיר גם את reporting_time_zone וגם את display_time_zone.

בקריאות, time_zone תמיד מחזיר את display_time_zone. אם השדה display_time_zone לא קיים בחשבון, השדה time_zone יהיה ריק.
language_code

string

חובה. קוד השפה BCP-47 של החשבון, למשל en-US או sr-Latn.

AccountAggregation

אין שדות לסוג הזה.

AccountAggregation עומס שימושי.

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 הבעיה היא הצעה לשיפור.

כתובת

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

שדות
street_address

string

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

string

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

string

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

string

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

string

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

AutofeedSettings

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

שדות
name

string

מזהה. שם המשאב של הגדרות הפיד האוטומטי. פורמט: accounts/{account}/autofeedSettings
enable_products

bool

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

bool

פלט בלבד. קובע אם המוכר עומד בדרישות להצטרפות ל-Autofeed.

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

ההודעה BusinessInfo מכילה מידע חיוני על העסק של המוכר.

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

שדות
name

string

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

PostalAddress

זה שינוי אופציונלי. הכתובת של העסק. רק השדות region_code, ‏ address_lines, ‏ postal_code, ‏ administrative_area ו-locality נתמכים. המערכת תתעלם משאר השדות.
phone

PhoneNumber

פלט בלבד. מספר הטלפון של העסק.
phone_verification_state

PhoneVerificationState

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

CustomerService

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

string

זה שינוי אופציונלי. מספר הרישום לעסק בקוריאה בן 10 הספרות, מופרד בקו מפריד בפורמט: XXX-XX-XXXXX.

CarrierRate

רשימה של תעריפי ספקים שאפשר להפנות אליה באמצעות main_table או single_value. שירותי הספקים הנתמכים מוגדרים בכתובת https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.

שדות
name

string

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

string

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

string

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

string

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

string

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

Price

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

ClaimHomepageRequest

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

שדות
name

string

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

bool

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

CreateAndConfigureAccountRequest

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

שדות
account

Account

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

CreateUserRequest

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

AddAccountService

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

AddAccountService

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

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

AccountAggregation

הספק הוא אגרטור של החשבון. עומס נתונים שימושי (payload) לשירות מסוג 'צבירה של חשבונות'.
provider

string

חובה. ספק השירות. פורמט: accounts/{account}

CreateRegionRequest

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

שדות
parent

string

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

string

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

Region

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

CreateUserRequest

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

שדות
parent

string

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

string

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

User

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

CustomerService

פרטי שירות הלקוחות.

שדות
uri

string

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

string

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

PhoneNumber

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

CutoffTime

הגדרת מועד הסגירה בימי עסקים.

שדות
hour

int32

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

int32

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

string

חובה. מזהה אזור זמן. לדוגמה: 'Europe/Zurich'.

DeleteAccountRequest

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

שדות
name

string

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

bool

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

DeleteRegionRequest

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

שדות
name

string

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

DeleteUserRequest

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

שדות
name

string

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

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

DeliveryTime

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

שדות
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

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

int32

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

int32

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

CutoffTime

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

int32

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

int32

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

TransitTable

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

BusinessDayConfig

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

BusinessDayConfig

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

DisableProgramRequest

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

שדות
name

string

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

מרחק

רדיוס המסירה המקסימלי. האפשרות הזו נדרשת רק לסוג המשלוח 'איסוף בחנות'.

שדות
value

int64

ערך שלם של המרחק.
unit

Unit

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

יחידה

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

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

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

שדות
name

string

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

GetAccountRequest

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

שדות
name

string

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

GetAutofeedSettingsRequest

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

שדות
name

string

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

GetBusinessIdentityRequest

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

שדות
name

string

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

GetBusinessInfoRequest

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

שדות
name

string

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

GetEmailPreferencesRequest

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

שדות
name

string

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

GetHomepageRequest

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

שדות
name

string

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

GetOnlineReturnPolicyRequest

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

שדות
name

string

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

GetProgramRequest

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

שדות
name

string

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

GetRegionRequest

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

שדות
name

string

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

GetShippingSettingsRequest

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

שדות
name

string

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

GetTermsOfServiceAgreementStateRequest

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

שדות
name

string

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

GetTermsOfServiceRequest

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

שדות
name

string

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

GetUserRequest

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

שדות
name

string

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

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

כותרות

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

שדות
prices[]

Price

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

Weight

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

string

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

string

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

LocationIdSet

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

דף הבית

ההודעה Homepage מייצגת את דף הבית של חנות של מוכר במערכת.

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

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

שדות
name

string

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

bool

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

string

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

InsertShippingSettingsRequest

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

שדות
parent

string

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

ShippingSettings

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

ListAccountIssuesRequest

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

שדות
parent

string

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

int32

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

string

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

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

string

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

string

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

ListAccountIssuesResponse

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

שדות
account_issues[]

AccountIssue

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

string

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

ListAccountsRequest

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

שדות
page_size

int32

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

string

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

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

string

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

ListAccountsResponse

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

שדות
accounts[]

Account

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

string

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

ListOnlineReturnPoliciesRequest

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

שדות
parent

string

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

int32

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

string

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

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

ListOnlineReturnPoliciesResponse

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

שדות
online_return_policies[]

OnlineReturnPolicy

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

string

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

ListProgramsRequest

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

שדות
parent

string

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

int32

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

string

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

ListProgramsResponse

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

שדות
programs[]

Program

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

string

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

ListRegionsRequest

הודעת הבקשה של השיטה 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

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

שדות
provider

string

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

int32

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

string

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

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

ListSubAccountsResponse

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

שדות
accounts[]

Account

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

string

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

ListUsersRequest

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

שדות
parent

string

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

int32

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

string

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

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

ListUsersResponse

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

שדות
users[]

User

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

string

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

LocationIdSet

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

שדות
location_ids[]

string

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

MinimumOrderValueTable

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

שדות
store_code_set_with_movs[]

StoreCodeSetWithMov

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

StoreCodeSetWithMov

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

שדות
store_codes[]

string

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

Price

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

OnlineReturnPolicy

האובייקט 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

אחוז מתוך המחיר הכולל ב-Micros. 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

הערך של קבוצת התעריפים (לדוגמה, תשלום קבוע בסך 10$). אפשר להגדיר את השדה הזה רק אם השדות main_table ו-subtables לא מוגדרים.
main_table

Table

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

string

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

אזור

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

שדות
name

string

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

PostalCodeArea

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

GeoTargetArea

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

BoolValue

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

BoolValue

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

string

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

GeoTargetArea

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

שדות
geotarget_criteria_ids[]

int64

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

PostalCodeArea

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

שדות
region_code

string

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

PostalCodeRange

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

PostalCodeRange

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

שדות
begin

string

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

string

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

חובה

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

שדות
terms_of_service

string

termsOfService שצריך לאשר.
tos_file_uri

string

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

RetrieveForApplicationTermsOfServiceAgreementStateRequest

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

שדות
parent

string

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

RetrieveLatestTermsOfServiceRequest

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

שדות
region_code

string

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

TermsOfServiceKind

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

שורה

כוללים רשימה של תאים.

שדות
cells[]

Value

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

שירות

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

שדות
delivery_countries[]

string

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

RateGroup

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

LoyaltyProgram

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

string

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

bool

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

string

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

DeliveryTime

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

ShipmentType

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

Price

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

MinimumOrderValueTable

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

StoreConfig

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

LoyaltyProgram

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

שדות
loyalty_program_tiers[]

LoyaltyProgramTiers

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

string

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

LoyaltyProgramTiers

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

שדות
tier_label

string

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

ShipmentType

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

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

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

LocalCutoffTime

השעה שבה מסתיימת המסירה באותו יום.

שדות
hour

int64

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

int64

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

StoreServiceType

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

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

ShippingSettings

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

שדות
name

string

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

Service

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

Warehouse

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

string

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

  1. מגדירים את השדה etag כמחרוזת ריקה ליצירת ההגדרות הראשוניות של המשלוח.

  2. אחרי היצירה הראשונית, צריך לקרוא ל-method get כדי לקבל את ה-etag ואת נתוני הגדרות המשלוח הנוכחיים לפני הקריאה ל-insert.

  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

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

TermsOfService

ההודעה TermsOfService מייצגת גרסה ספציפית של התנאים וההגבלות שמוכרים חייבים לאשר כדי לגשת לתכונות או לשירותים מסוימים (מידע נוסף זמין בכתובת https://support.google.com/merchants/answer/160173).

ההודעה הזו חשובה לתהליך ההצטרפות, והיא נועדה לוודא שהמוכרים מסכימים להסכמים המשפטיים הנדרשים לשימוש בשירות. מוכרים יכולים לאחזר את התנאים וההגבלות העדכניים של kind ו-region נתונים באמצעות RetrieveLatestTermsOfService, ולאשר אותם כנדרש באמצעות AcceptTermsOfService.

שדות
name

string

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

string

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

TermsOfServiceKind

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

bool

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

string

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

TermsOfServiceAgreementState

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

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

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

שדות
name

string

מזהה. שם המשאב של גרסת התנאים וההגבלות. פורמט: accounts/{account}/termsOfServiceAgreementState/{identifier} הפורמט של המזהה הוא: {TermsOfServiceKind}-{country} לדוגמה, מזהה יכול להיות: MERCHANT_CENTER-US
region_code

string

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

TermsOfServiceKind

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

Accepted

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

Required

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

TermsOfServiceKind

הסוג TermsOfService.

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

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

שדות
name

string

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

UpdateAccountRequest

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

שדות
account

Account

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

FieldMask

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

השדות הבאים נתמכים (גם ב-snake_case וגם ב-lowerCamelCase):

  • account_name
  • adult_content
  • language_code
  • time_zone

UpdateAutofeedSettingsRequest

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

שדות
autofeed_settings

AutofeedSettings

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

FieldMask

חובה. רשימת השדות שמתעדכנים.

UpdateBusinessIdentityRequest

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

שדות
business_identity

BusinessIdentity

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

FieldMask

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

השדות הבאים נתמכים (גם ב-snake_case וגם ב-lowerCamelCase):

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

UpdateBusinessInfoRequest

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

שדות
business_info

BusinessInfo

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

FieldMask

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

השדות הבאים נתמכים (גם ב-snake_case וגם ב-lowerCamelCase):

  • address
  • customer_service
  • korean_business_registration_number

UpdateEmailPreferencesRequest

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

שדות
email_preferences

EmailPreferences

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

FieldMask

חובה. רשימת השדות שמתעדכנים.

השדות הבאים נתמכים (גם ב-snake_case וגם ב-lowerCamelCase):

  • news_and_tips

UpdateHomepageRequest

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

שדות
homepage

Homepage

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

FieldMask

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

השדות הבאים נתמכים (גם ב-snake_case וגם ב-lowerCamelCase):

  • uri

UpdateRegionRequest

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

שדות
region

Region

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

FieldMask

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

UpdateUserRequest

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

שדות
user

User

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

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

FieldMask

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

השדות הבאים נתמכים (גם ב-snake_case וגם ב-lowerCamelCase):

  • access_rights

משתמש

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

שדות
name

string

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

משתמשים ב-me כדי להפנות לכתובת האימייל שלכם, לדוגמה accounts/{account}/users/me.
state

State

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

AccessRight

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

מדינה

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

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

ערך

הערך היחיד של קבוצת שיעורי ריבית או הערך של תא בטבלה של קבוצת שיעורי ריבית. צריך להגדיר בדיוק אחד מהערכים 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

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

מחסן

מחסן לטיפול בהזמנות, שבו מאוחסן המלאי וממנו הוא מטופל.

שדות
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

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