אינדקס
AccountIssueService
(ממשק)AccountTaxService
(ממשק)AccountsService
(ממשק)BusinessIdentityService
(ממשק)BusinessInfoService
(ממשק)EmailPreferencesService
(ממשק)HomepageService
(ממשק)OnlineReturnPolicyService
(ממשק)ProgramsService
(ממשק)RegionsService
(ממשק)ShippingSettingsService
(ממשק)TermsOfServiceAgreementStateService
(ממשק)TermsOfServiceService
(ממשק)UserService
(ממשק)AcceptTermsOfServiceRequest
(הודעה)Accepted
(הודעה)AccessRight
(טיפוס טיפוסים בני מנייה (enum))Account
(הודעה)AccountIssue
(הודעה)AccountIssue.ImpactedDestination
(הודעה)AccountIssue.ImpactedDestination.Impact
(הודעה)AccountIssue.Severity
(טיפוס טיפוסים בני מנייה (enum))AccountTax
(הודעה)Address
(הודעה)BusinessDayConfig
(הודעה)BusinessDayConfig.Weekday
(טיפוס טיפוסים בני מנייה (enum))BusinessIdentity
(הודעה)BusinessIdentity.IdentityAttribute
(הודעה)BusinessIdentity.IdentityAttribute.IdentityDeclaration
(טיפוס טיפוסים בני מנייה (enum))BusinessIdentity.PromotionsConsent
(טיפוס טיפוסים בני מנייה (enum))BusinessInfo
(הודעה)CarrierRate
(הודעה)ClaimHomepageRequest
(הודעה)CreateAndConfigureAccountRequest
(הודעה)CreateAndConfigureAccountRequest.AcceptTermsOfService
(הודעה)CreateAndConfigureAccountRequest.AddAccountService
(הודעה)CreateRegionRequest
(הודעה)CreateUserRequest
(הודעה)CustomerService
(הודעה)CutoffTime
(הודעה)DeleteAccountRequest
(הודעה)DeleteRegionRequest
(הודעה)DeleteUserRequest
(הודעה)DeliveryTime
(הודעה)DisableProgramRequest
(הודעה)Distance
(הודעה)Distance.Unit
(טיפוס טיפוסים בני מנייה (enum))EmailPreferences
(הודעה)EmailPreferences.OptInState
(טיפוס טיפוסים בני מנייה (enum))EnableProgramRequest
(הודעה)GetAccountRequest
(הודעה)GetAccountTaxRequest
(הודעה)GetBusinessIdentityRequest
(הודעה)GetBusinessInfoRequest
(הודעה)GetEmailPreferencesRequest
(הודעה)GetHomepageRequest
(הודעה)GetOnlineReturnPolicyRequest
(הודעה)GetProgramRequest
(הודעה)GetRegionRequest
(הודעה)GetShippingSettingsRequest
(הודעה)GetTermsOfServiceAgreementStateRequest
(הודעה)GetTermsOfServiceRequest
(הודעה)GetUserRequest
(הודעה)Headers
(הודעה)Homepage
(הודעה)InsertShippingSettingsRequest
(הודעה)ListAccountIssuesRequest
(הודעה)ListAccountIssuesResponse
(הודעה)ListAccountsRequest
(הודעה)ListAccountsResponse
(הודעה)ListOnlineReturnPoliciesRequest
(הודעה)ListOnlineReturnPoliciesResponse
(הודעה)ListProgramsRequest
(הודעה)ListProgramsResponse
(הודעה)ListRegionsRequest
(הודעה)ListRegionsResponse
(הודעה)ListSubAccountsRequest
(הודעה)ListSubAccountsResponse
(הודעה)ListUsersRequest
(הודעה)ListUsersResponse
(הודעה)LocationIdSet
(הודעה)MinimumOrderValueTable
(הודעה)MinimumOrderValueTable.StoreCodeSetWithMov
(הודעה)OnlineReturnPolicy
(הודעה)OnlineReturnPolicy.ItemCondition
(טיפוס טיפוסים בני מנייה (enum))OnlineReturnPolicy.Policy
(הודעה)OnlineReturnPolicy.Policy.Type
(טיפוס טיפוסים בני מנייה (enum))OnlineReturnPolicy.RestockingFee
(הודעה)OnlineReturnPolicy.ReturnMethod
(טיפוס טיפוסים בני מנייה (enum))OnlineReturnPolicy.ReturnShippingFee
(הודעה)OnlineReturnPolicy.ReturnShippingFee.Type
(טיפוס טיפוסים בני מנייה (enum))PhoneVerificationState
(טיפוס טיפוסים בני מנייה (enum))Program
(הודעה)Program.Requirement
(הודעה)Program.State
(טיפוס טיפוסים בני מנייה (enum))RateGroup
(הודעה)Region
(הודעה)Region.GeoTargetArea
(הודעה)Region.PostalCodeArea
(הודעה)Region.PostalCodeArea.PostalCodeRange
(הודעה)Required
(הודעה)RetrieveForApplicationTermsOfServiceAgreementStateRequest
(הודעה)RetrieveLatestTermsOfServiceRequest
(הודעה)Row
(הודעה)Service
(הודעה)Service.LoyaltyProgram
(הודעה)Service.LoyaltyProgram.LoyaltyProgramTiers
(הודעה)Service.ShipmentType
(טיפוס טיפוסים בני מנייה (enum))Service.StoreConfig
(הודעה)Service.StoreConfig.CutoffConfig
(הודעה)Service.StoreConfig.CutoffConfig.LocalCutoffTime
(הודעה)Service.StoreConfig.StoreServiceType
(טיפוס טיפוסים בני מנייה (enum))ShippingSettings
(הודעה)Table
(הודעה)TaxRule
(הודעה)TaxRule.TaxPostalCodeRange
(הודעה)TermsOfService
(הודעה)TermsOfServiceAgreementState
(הודעה)TermsOfServiceKind
(טיפוס טיפוסים בני מנייה (enum))TransitTable
(הודעה)TransitTable.TransitTimeRow
(הודעה)TransitTable.TransitTimeRow.TransitTimeValue
(הודעה)UnclaimHomepageRequest
(הודעה)UpdateAccountRequest
(הודעה)UpdateAccountTaxRequest
(הודעה)UpdateBusinessIdentityRequest
(הודעה)UpdateBusinessInfoRequest
(הודעה)UpdateEmailPreferencesRequest
(הודעה)UpdateHomepageRequest
(הודעה)UpdateRegionRequest
(הודעה)UpdateUserRequest
(הודעה)User
(הודעה)User.State
(טיפוס טיפוסים בני מנייה (enum))Value
(הודעה)Warehouse
(הודעה)WarehouseBasedDeliveryTime
(הודעה)WarehouseCutoffTime
(הודעה)
AccountIssueService
שירות לתמיכה ב-API של AccountIssueService
.
ListAccountIssues |
---|
רשימה של כל הבעיות בחשבון Merchant Center.
|
AccountTaxService
ניהול נתוני הגדרות מס ברמת החשבון.
ה-API הזה מגדיר את מודל המשאבים הבא:
AccountTax
GetAccountTax |
---|
פונקציה זו מחזירה את כללי המס שתואמים לתנאים של GetAccountTaxRequest
|
UpdateAccountTax |
---|
מעדכנים את הגדרות המס של החשבון.
|
AccountsService
שירות לתמיכה ב-Accounts API.
CreateAndConfigureAccount |
---|
יצירת חשבון Merchant Center עצמאי עם הגדרות נוספות. הוספת המשתמש ששלח את הבקשה כאדמין בחשבון החדש.
|
DeleteAccount |
---|
מחיקת החשבון שצוין, ללא קשר לסוג שלו: עצמאי, חשבון MCA או חשבון משנה. מחיקה של חשבון MCA מובילה למחיקה של כל חשבונות המשנה שלו. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
GetAccount |
---|
אחזור של חשבון מחשבון Merchant Center. אחרי הוספה, עדכון או מחיקה של חשבון, יכול להיות שיחלפו כמה דקות עד שהשינויים ייכנסו לתוקף.
|
ListAccounts |
---|
רשימת חשבונות שאפשר לגשת אליהם רק אם המשתמש שמתקשר יכול להתאים למגבלות של הבקשה, כמו גודל הדף או מסננים. לא מדובר רק בחשבונות המשנה של חשבון MCA, אלא גם בכל החשבונות שלמשתמש המתקשר יש גישה אליהם, כולל חשבונות MCA אחרים, חשבונות מקושרים, חשבונות עצמאיים ועוד.
|
ListSubAccounts |
---|
להציג רשימה של כל חשבונות המשנה של חשבון מרובה לקוחות מסוים. זוהי wrapper במסגרת הנוחות של השיטה
|
UpdateAccount |
---|
מעדכנים את החשבון ללא קשר לסוג שלו: חשבון עצמאי, חשבון MCA או חשבון משנה. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
BusinessIdentityService
שירות לתמיכה ב-API של זהות העסק.
GetBusinessIdentity |
---|
אחזור של זהות העסק של החשבון.
|
UpdateBusinessIdentity |
---|
עדכון של זהות העסק בחשבון. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
BusinessInfoService
שירות לתמיכה ב-Business info API.
GetBusinessInfo |
---|
אחזור של פרטי העסק של חשבון.
|
UpdateBusinessInfo |
---|
עדכון פרטי העסק של החשבון. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
EmailPreferencesService
שירות לתמיכה ב-API של EmailPreferences
.
השירות הזה מאפשר אחזור ועדכון של העדפות אימייל רק עבור משתמשים מאומתים.
GetEmailPreferences |
---|
הפונקציה מחזירה את העדפות האימייל של משתמש בחשבון Merchant Center. השתמשו בכינוי name=accounts/*/users/me/emailPreferences כדי לקבל העדפות עבור המשתמש המאומת.
|
UpdateEmailPreferences |
---|
מעדכן את העדפות האימייל של משתמש בחשבון Merchant Center. משתמשי ה-MCA צריכים לציין את החשבון ה-MCA ולא את חשבון המשנה של ה-MCA. העדפות שלא נבחרו במפורש במסכת העדכון לא יעודכנו. לא ניתן להשתמש בעדכונים שבהם יצוין ערך סטטוס ההסכמה 'לא אושר'. השתמשו בכינוי name=accounts/*/users/me/emailPreferences כדי לעדכן את ההעדפות עבור המשתמש המאומת.
|
HomepageService
שירות לתמיכה ב-API לדף הבית של חנות.
ClaimHomepage |
---|
תביעת בעלות על דף הבית של חנות. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין. אם כבר נתבעה בעלות על דף הבית, המערכת תבדוק שוב את האימות (אלא אם המוכר פטור מתביעת בעלות, שגם פטור מאימות) ותחזיר תשובה מוצלחת. אם כבר אי אפשר לאמת את הבעלות, תוחזר הודעת שגיאה אבל לא תמחק את התלונה. במקרה של כשל, תוחזר הודעת שגיאה קנונית: * permission_DENIED: למשתמש אין את ההרשאות הנדרשות בחשבון MC הזה; * FAILED_PRE conditions: - החשבון אינו חשבון Merchant Center; - לחשבון MC אין דף בית. - התביעה נכשלה (במקרה זה, הודעת השגיאה תכלול פרטים נוספים).
|
GetHomepage |
---|
אחזור דף הבית של חנות.
|
UnclaimHomepage |
---|
מבטל את תביעת הבעלות על דף הבית של חנות. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
UpdateHomepage |
---|
מעדכן את דף הבית של חנות. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
OnlineReturnPolicyService
השירות מאפשר למוכר לנהל את ההגדרה של מדיניות החזרת מוצרים שחרטה, וכולל מדיניות החזרת מוצרים גם במודעות וגם בכרטיסי מוצר חינמיים
התוכניות השונות. ה-API הזה מגדיר את מודל המשאבים הבא:
[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]
GetOnlineReturnPolicy |
---|
מקבל מדיניות החזרת מוצרים קיימת.
|
ListOnlineReturnPolicies |
---|
בתיבת הדו-שיח הזו מפורטים כל כללי מדיניות החזרת המוצרים הקיימים.
|
ProgramsService
שירות לניהול תוכנית.
התוכניות מספקות מנגנון להוספת פונקציונליות לחשבונות המוכרים. דוגמה אופיינית לכך היא התוכנית כרטיסי מוצר חינמיים, שמאפשרת להציג ב-Google בחינם מוצרים מחנות של מוֹכר.
בשירות הזה מפורטות שיטות לאחזור ההשתתפות של מוֹכר בכל התוכניות הזמינות, בנוסף לשיטות להפעלה או להשבתה של ההשתתפות באופן מפורש בכל תוכנית.
DisableProgram |
---|
להשבית את ההשתתפות בתוכנית שצוינה עבור החשבון. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
EnableProgram |
---|
להפעיל את ההשתתפות בתוכנית שצוינה בחשבון. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
GetProgram |
---|
אחזור של התוכנית שצוינה עבור החשבון.
|
ListPrograms |
---|
אחזור כל התוכניות של החשבון.
|
RegionsService
ניהול של הגדרת האזורים.
ה-API הזה מגדיר את מודל המשאבים הבא:
Region
CreateRegion |
---|
ההגדרה הזו יוצרת את הגדרת האזור בחשבון Merchant Center. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
DeleteRegion |
---|
מחיקת הגדרת אזור מחשבון Merchant Center שלכם. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
GetRegion |
---|
אחזור אזור שהוגדר בחשבון Merchant Center.
|
ListRegions |
---|
בתיבת הדו-שיח הזו מפורטים האזורים בחשבון Merchant Center שלכם.
|
UpdateRegion |
---|
לעדכן הגדרת אזור בחשבון Merchant Center. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
ShippingSettingsService
שירות לקבלת מידע על הגדרת המשלוח של קריאה לשיטה לפי שיטת ה-Merchant API.
GetShippingSettings |
---|
אחזור פרטים של הגדרות משלוח.
|
InsertShippingSettings |
---|
מחליפים את הגדרת המשלוח של המוכר בהגדרת המשלוח של הבקשה. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
TermsOfServiceAgreementStateService
שירות לתמיכה ב-API של TermsOfServiceAgreementState
.
GetTermsOfServiceAgreementState |
---|
מחזירה את המצב של הסכם התנאים וההגבלות.
|
RetrieveForApplicationTermsOfServiceAgreementState |
---|
אחזור של מצב ההסכם עבור התנאים וההגבלות של האפליקציה.
|
TermsOfServiceService
שירות לתמיכה ב-API של TermsOfService
.
AcceptTermsOfService |
---|
מקבלים
|
GetTermsOfService |
---|
אחזור
|
RetrieveLatestTermsOfService |
---|
מאחזר את הגרסה האחרונה של
|
UserService
שירות לתמיכה ב-API למשתמש.
CreateUser |
---|
יצירת משתמש בחשבון Merchant Center. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
DeleteUser |
---|
מחיקת משתמש בחשבון Merchant Center. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
GetUser |
---|
אחזור של משתמש בחשבון Merchant Center.
|
ListUsers |
---|
רשימה של כל המשתמשים בחשבון Merchant Center.
|
UpdateUser |
---|
עדכון משתמש בחשבון Merchant Center. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.
|
AcceptTermsOfServiceRequest
בקשת הודעה ל-method AcceptTermsOfService
.
שדות | |
---|---|
name |
חובה. שם המשאב של גרסת התנאים וההגבלות. פורמט: |
account |
חובה. החשבון שעבורו צריך לאשר את התנאים וההגבלות. |
region_code |
חובה. קוד האזור כפי שהוגדר על ידי CLDR. מדובר במדינה שבה התנאים וההגבלות חלים באופן ספציפי על אותה מדינה, או אם התנאים וההגבלות חלים בכל העולם, או קוד 001. |
אושרו
תיאור של התנאים וההגבלות הקבילים.
שדות | |
---|---|
terms_of_service |
termsOfService הקבילים. |
accepted_by |
החשבון שבו נרשמה האישור. החשבון יכול להיות החשבון עצמו, או חשבון ה-MCA כשמדובר בחשבונות משנה. |
valid_until |
אם המדיניות מוגדרת, היא מצהירה שTermsOfService המקובלים תקפים רק עד סוף התאריך הזה (לפי שעון UTC). יש לאשר אישור חדש לפני כן. המידע של ה-TermsOfService הנדרשים מופיע בהודעה החובה. |
AccessRight
הרשאת הגישה הנכונה.
טיפוסים בני מנייה (enum) | |
---|---|
ACCESS_RIGHT_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה לא בשימוש. |
STANDARD |
הרשאות גישה רגילות. |
ADMIN |
הרשאות גישה של אדמין. |
PERFORMANCE_REPORTING |
למשתמשים עם הזכות הזו יש גישה לביצועים ולתובנות. |
חשבון
חשבון.
שדות | |
---|---|
name |
מזהה. שם המשאב של החשבון. פורמט: |
account_id |
פלט בלבד. המספר המזהה של החשבון. |
account_name |
חובה. שם החשבון שקריא לאנשים. מידע נוסף זמין בקטע שם החנות ושם העסק. |
adult_content |
אם החשבון הזה מכיל תוכן למבוגרים בלבד. |
test_account |
פלט בלבד. האם זהו חשבון בדיקה. |
time_zone |
חובה. אזור הזמן של החשבון. במצב כתיבה, בקריאות, |
language_code |
חובה. קוד השפה BCP-47 של החשבון, כמו |
AccountIssue
שדות | |
---|---|
name |
מזהה. שם המשאב של הבעיה בחשבון. פורמט: |
title |
השם המותאם לשוק המקומי של הבעיה. |
severity |
החומרה הכוללת של הבעיה. |
impacted_destinations[] |
ההשפעה של הבעיה על יעדים שונים. |
detail |
פרטים נוספים על הבעיה שמותאמים לשוק המקומי. |
documentation_uri |
קישור אל מרכז העזרה של Merchant Center יאפשר לך לקבל מידע נוסף על הבעיה וללמוד איך לפתור אותה. |
ImpactedDestination
ההשפעה של הבעיה על יעד מסוים.
שדות | |
---|---|
impacts[] |
ההשפעה (השלילית) של אזורים שונים על היעד הנתון. |
reporting_context |
ההקשר של הדיווח שהושפע. |
השפעה
ההשפעה של הבעיה על אזור מסוים.
שדות | |
---|---|
region_code |
קוד האזור במאגר CLDR שבו רלוונטית הבעיה הזו. |
severity |
חומרת הבעיה ביעד ובאזור. |
מידת החומרה
כל מידות החומרה האפשריות של בעיות.
טיפוסים בני מנייה (enum) | |
---|---|
SEVERITY_UNSPECIFIED |
חוּמרה אינה ידועה. |
CRITICAL |
הבעיה גורמת לכך שהמוצרים לא מוצגים. |
ERROR |
הבעיה יכולה להשפיע על מוצרים (בעתיד) או להצביע על בעיות במוצרים. |
SUGGESTION |
הבעיה היא הצעה לשיפור. |
AccountTax
הגדרות המס של חשבון מוכר. בכל השיטות נדרש תפקיד אדמין.
שדות | |
---|---|
name |
מזהה. השם של הגדרת המס. פורמט: "{account_tax.name=accounts/{account}}" |
account |
פלט בלבד. מספר החשבון שאליו שייכות הגדרות המס האלה של החשבון. |
tax_rules[] |
כללי מס. "מגדירים את כללי המס בכל אזור. לא יוצג מס אם לא הוגדר באזור כלל". |
כתובת
הכתובת למשלוח של המחסן.
שדות | |
---|---|
street_address |
חלק של הכתובת ברמת הרחוב. לדוגמה: |
city |
חובה. עיר, עיירה או קהילה. עשוי לכלול גם רשויות מוניציפאליות או אזורי משנה (לדוגמה, שכונות או פרברים). |
administrative_area |
חובה. חלוקת משנה מנהלית ברמה העליונה של המדינה. לדוגמה, מדינה כמו קליפורניה (CA) או מחוז כמו קוויבק (QC). |
postal_code |
חובה. מיקוד (לדוגמה "94043"). |
region_code |
חובה. קוד מדינה במאגר CLDR (לדוגמה, 'US'). |
BusinessDayConfig
ימי העסקים במחסן.
שדות | |
---|---|
business_days[] |
חובה. ימי עסקים קבועים. השדה לא יכול להיות ריק. |
יום חול
טיפוסים בני מנייה (enum) | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
BusinessIdentity
אוסף של מידע שקשור לזהות של עסק.
שדות | |
---|---|
name |
מזהה. שם המשאב של זהות העסק. פורמט: |
promotions_consent |
זה שינוי אופציונלי. אם אפשר להשתמש במאפייני הזהות למבצעים. |
black_owned |
זה שינוי אופציונלי. מציין אם העסק מזדהה כעסק בבעלות אדם שחור. השדה האופציונלי הזה יהיה זמין רק למוכרים שמדינת העסק שלהם מוגדרת כ- |
women_owned |
זה שינוי אופציונלי. מציין אם העסק מזהה את עצמו כעסק בבעלות אישה. השדה האופציונלי הזה יהיה זמין רק למוכרים שמדינת העסק שלהם מוגדרת כ- |
veteran_owned |
זה שינוי אופציונלי. מציין אם העסק מזהה את עצמו כעסק בבעלות יוצא מן הכלל. השדה האופציונלי הזה יהיה זמין רק למוכרים שמדינת העסק שלהם מוגדרת כ- |
latino_owned |
זה שינוי אופציונלי. מציין אם העסק מזדהה כעסק בבעלות אדם לטיני. השדה האופציונלי הזה יהיה זמין רק למוכרים שמדינת העסק שלהם מוגדרת כ- |
small_business |
זה שינוי אופציונלי. מציין אם העסק מזדהה כעסק קטן. השדה האופציונלי הזה יהיה זמין רק למוכרים שמדינת העסק שלהם מוגדרת כ- |
IdentityAttribute
כל המידע שקשור למאפיין זהות.
שדות | |
---|---|
identity_declaration |
חובה. הצהרת הזהות של המאפיין הזה. |
IdentityDeclaration
כל ההגדרות האפשריות להצהרה על זהות.
טיפוסים בני מנייה (enum) | |
---|---|
IDENTITY_DECLARATION_UNSPECIFIED |
ערך ברירת מחדל שמציין שלא בוצעה בחירה. |
SELF_IDENTIFIES_AS |
מציין שהחשבון מזדהה עם המאפיין. |
DOES_NOT_SELF_IDENTIFY_AS |
מציין שהחשבון לא מזדהה עם המאפיין. |
PromotionsConsent
כל ההגדרות האפשריות בנוגע למבצעים שקשורים לזהות העסק.
טיפוסים בני מנייה (enum) | |
---|---|
PROMOTIONS_CONSENT_UNSPECIFIED |
ערך ברירת מחדל שמציין שלא בוצעה בחירה. |
PROMOTIONS_CONSENT_GIVEN |
מציין שהחשבון הביע הסכמה לכך שזהות העסק שלו תשמש לקידומים. |
PROMOTIONS_CONSENT_DENIED |
מציין שהחשבון לא הביע הסכמה לכך שזהות העסק שלו תשמש לקידומי מכירות. |
BusinessInfo
אוסף של מידע שקשור לעסק.
שדות | |
---|---|
name |
מזהה. שם המשאב של פרטי העסק. פורמט: |
address |
זה שינוי אופציונלי. כתובת העסק. |
phone |
פלט בלבד. מספר הטלפון של העסק. |
phone_verification_state |
פלט בלבד. מצב האימות הטלפוני של העסק. |
customer_service |
זה שינוי אופציונלי. שירות הלקוחות של העסק. |
CarrierRate
רשימה של תעריפים של חברות תובלה שאפשר להתייחס אליהם לפי main_table
או single_value
.
שדות | |
---|---|
name |
חובה. שם התעריף של חברת התובלה. חייב להיות ייחודי לכל קבוצת תעריפים. |
carrier |
חובה. השירות של ספק הסלולר, למשל |
carrier_service |
חובה. השירות של ספק הסלולר, למשל |
origin_postal_code |
חובה. מקור המשלוח בתעריף הזה של חברת התובלה. |
percentage_adjustment |
זה שינוי אופציונלי. הכפלה של תעריף המשלוח כמספר בסימון עשרוני. יכול להיות שלילי. לדוגמה: הדגל |
flat_adjustment |
זה שינוי אופציונלי. ערך מוסף של תעריף משלוח. יכול להיות שלילי. לדוגמה, |
ClaimHomepageRequest
בקשת הודעה ל-method ClaimHomepage
.
שדות | |
---|---|
name |
חובה. השם של דף הבית שעליו רוצים לתבוע בעלות. פורמט: |
CreateAndConfigureAccountRequest
בקשת הודעה ל-method CreateAndConfigureAccount
.
שדות | |
---|---|
account |
חובה. החשבון ליצירה. |
users[] |
זה שינוי אופציונלי. משתמשים שיתווספו לחשבון. |
service[] |
זה שינוי אופציונלי. אם צוין, שירות חשבון בין החשבון שיש ליצור לבין חשבון הספק יופעל כחלק מתהליך היצירה. |
accept_terms_of_service |
זה שינוי אופציונלי. את התנאים וההגבלות (ToS) שצריך לאשר מיד לאחר יצירת החשבון. |
AcceptTermsOfService
הפניה למקור מידע של תנאים והגבלות.
שדות | |
---|---|
name |
חובה. שם המשאב של גרסת התנאים וההגבלות. |
region_code |
חובה. קוד האזור לפי ההגדרה של CLDR. מדובר במדינה שבה התנאים וההגבלות חלים באופן ספציפי על אותה מדינה, או ב |
AddAccountService
הוראות נוספות להוספת שירותי חשבון במהלך יצירת החשבון.
שדות | |
---|---|
שדה איחוד service_type . בשלב הזה יש תמיכה רק בחשבון הורה ריבוי לקוחות. service_type יכול להיות רק אחת מהאפשרויות הבאות: |
|
account_aggregation |
הספק הוא אתר אגרגטור לחשבון. |
provider |
זה שינוי אופציונלי. ספק השירות. פורמט: |
CreateRegionRequest
בקשת הודעה ל-method CreateRegion
.
שדות | |
---|---|
parent |
חובה. החשבון שעבורו רוצים ליצור אזור. פורמט: |
region_id |
חובה. המזהה של האזור, שהוא מזהה ייחודי בכל האזורים של אותו חשבון. |
region |
חובה. האזור שצריך ליצור. |
CreateUserRequest
בקשת הודעה ל-method CreateUser
.
שדות | |
---|---|
parent |
חובה. שם המשאב של החשבון שבשבילו ייווצר משתמש. פורמט: |
user_id |
חובה. כתובת האימייל של המשתמש (לדוגמה, |
user |
חובה. המשתמש שצריך ליצור. |
CustomerService
מידע על שירות הלקוחות.
שדות | |
---|---|
uri |
זה שינוי אופציונלי. ה-URI שבו ניתן למצוא את שירות הלקוחות. |
email |
זה שינוי אופציונלי. כתובת האימייל שבאמצעותה ניתן ליצור קשר עם שירות הלקוחות. |
phone |
זה שינוי אופציונלי. מספר הטלפון שאליו ניתן להתקשר לשירות הלקוחות. |
CutoffTime
הגדרת המועד האחרון להזמנה של ימי עסקים.
שדות | |
---|---|
hour |
חובה. השעה המאוחרת ביותר שבמהלכה צריך לבצע הזמנה כדי שהיא תטופל באותו יום. |
minute |
חובה. הדקה של המועד האחרון שעד אליו צריך לבצע הזמנה כדי שההזמנה תעובד באותו יום. |
time_zone |
חובה. מזהה אזור זמן. לדוגמה, 'אירופה/ציריך'. |
DeleteAccountRequest
בקשת הודעה ל-method DeleteAccount
.
שדות | |
---|---|
name |
חובה. שם החשבון שרוצים למחוק. פורמט: |
DeleteRegionRequest
בקשת הודעה ל-method DeleteRegion
.
שדות | |
---|---|
name |
חובה. שם האזור שרוצים למחוק. פורמט: |
DeleteUserRequest
בקשת הודעה ל-method DeleteUser
.
שדות | |
---|---|
name |
חובה. שם המשתמש שרוצים למחוק. פורמט: אפשר גם למחוק את המשתמש התואם למתקשר באמצעות |
DeliveryTime
הזמן שהוקדש להיבטים שונים, מרגע קבלת המוצר ועד למסירת המוצר.
שדות | |
---|---|
warehouse_based_delivery_times[] |
זה שינוי אופציונלי. מציין שיש לחשב את זמן האספקה לכל מחסן (מיקום המוצא של המשלוח) על סמך ההגדרות של חברת התובלה שנבחרה. אחרי ההגדרה הזו, לא יהיה מוגדר אף שדה אחר שקשור לזמן הובלה במאפיין [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]. |
min_transit_days |
המספר המינימלי של ימי עסקים למשלוח. 0 פירושו מסירה ביום הקנייה, 1 פירושו משלוח ביום המחרת. צריך להגדיר |
max_transit_days |
המספר המקסימלי של ימי עסקים שאפשר להשתמש בהם במעבר. 0 פירושו מסירה ביום הקנייה, 1 פירושו משלוח ביום המחרת. חייב להיות גדול מ- |
cutoff_time |
הגדרת המועד האחרון להזמנה של ימי עסקים. אם לא מגדירים את המועד האחרון להזמנה, ברירת המחדל תהיה 8:00 שעון החוף המערבי. |
min_handling_days |
מספר ימי העסקים המינימלי שנדרש לפני שההזמנה תישלח. המשמעות של 0 היא שנשלח ביום הקנייה, המשמעות של 1 היא המשלוח ביום המחרת. |
max_handling_days |
המספר המקסימלי של ימי עסקים שצריך להמתין לפני שההזמנה תישלח. המשמעות של 0 היא שנשלח ביום הקנייה, המשמעות של 1 היא המשלוח ביום המחרת. חייב להיות גדול מ- |
transit_time_table |
טבלת זמן הובלה, מספר ימי העסקים שהובלה על סמך מאפייני שורה ועמודה. אפשר להגדיר |
handling_business_day_config |
ימי העסקים שבמהלכם אפשר לטפל בהזמנות. אם לא תספקו כתובת, המערכת תתייחס לימי עסקים בימים שני עד שישי. |
transit_business_day_config |
ימי העסקים שבמהלכם ההזמנות יכולות להישלח. אם לא תספקו כתובת, המערכת תתייחס לימי עסקים בימים שני עד שישי. |
DisableProgramRequest
הודעת בקשה ל-method שלDisableProgram.
שדות | |
---|---|
name |
חובה. שם התוכנית שעבורה יש להשבית את ההשתתפות של החשבון הנתון. פורמט: |
מרחק
רדיוס מסירה מקסימלי. צריך לעשות זאת רק עבור סוג משלוח מקומי.
שדות | |
---|---|
value |
ערך מספר שלם של מרחק. |
unit |
היחידה עשויה להשתנות בהתאם למדינה, היא כוללת פרמטרים שכוללים מיילים וקילומטרים. |
יחידה
היחידה עשויה להשתנות בהתאם למדינה, היא כוללת פרמטרים שכוללים מיילים וקילומטרים.
טיפוסים בני מנייה (enum) | |
---|---|
UNIT_UNSPECIFIED |
לא צוינה יחידה |
MILES |
יחידה במיילים |
KILOMETERS |
יחידה בקילומטרים |
EmailPreferences
הקטגוריות של ההתראות שהמשתמש הביע הסכמה או ביטל את ההסכמה לקבל אותן. העדפות האימייל לא כוללות הודעות חשובות, כי המשתמשים לא יכולים לבטל את ההסכמה לקבלת הודעות כאלה.
שדות | |
---|---|
name |
מזהה. השם של EmailPreferences. נקודת הקצה נתמכת רק עבור המשתמש המאומת. |
news_and_tips |
זה שינוי אופציונלי. עדכונים על תכונות חדשות, טיפים ושיטות מומלצות. |
OptInState
המצב של העדפת האימייל.
טיפוסים בני מנייה (enum) | |
---|---|
OPT_IN_STATE_UNSPECIFIED |
סטטוס ההצטרפות לא צוין. |
OPTED_OUT |
המשתמש ביטל את ההסכמה לקבל אימייל מהסוג הזה. |
OPTED_IN |
המשתמש הביע הסכמה לקבלת אימייל מהסוג הזה. |
UNCONFIRMED |
המשתמש הביע הסכמה לקבלת אימייל מסוג זה והודעת האישור נשלחה באימייל, אבל המשתמש עדיין לא אישר את הבעת ההסכמה (רלוונטי רק למדינות מסוימות). |
EnableProgramRequest
הודעת בקשה ל-method EnableProgram.
שדות | |
---|---|
name |
חובה. שם התוכנית שמאפשרת השתתפות של החשבון הנתון. פורמט: |
GetAccountRequest
בקשת הודעה ל-method GetAccount
.
שדות | |
---|---|
name |
חובה. שם החשבון לאחזור. פורמט: |
GetAccountTaxRequest
בקשה לקבלת הגדרות מס
שדות | |
---|---|
name |
חובה. השם שממנו יישלפו הגדרות המס |
GetBusinessIdentityRequest
בקשת הודעה ל-method GetBusinessIdentity
.
שדות | |
---|---|
name |
חובה. שם המשאב של זהות העסק. פורמט: |
GetBusinessInfoRequest
בקשת הודעה ל-method GetBusinessInfo
.
שדות | |
---|---|
name |
חובה. שם המשאב של פרטי העסק. פורמט: |
GetEmailPreferencesRequest
בקשת הודעה לשיטת GetEmailPreferences.
שדות | |
---|---|
name |
חובה. שם המשאב |
GetHomepageRequest
בקשת הודעה ל-method GetHomepage
.
שדות | |
---|---|
name |
חובה. השם של דף הבית שצריך לאחזר. פורמט: |
GetOnlineReturnPolicyRequest
בקשת הודעה ל-method GetOnlineReturnPolicy
.
שדות | |
---|---|
name |
חובה. שם מדיניות החזרת המוצרים שיש לאחזר. פורמט: |
GetProgramRequest
הודעת בקשה לשיטת GetProgram.
שדות | |
---|---|
name |
חובה. שם התוכנית שצריך לאחזר. פורמט: |
GetRegionRequest
בקשת הודעה ל-method GetRegion
.
שדות | |
---|---|
name |
חובה. שם האזור שצריך לאחזר. פורמט: |
GetShippingSettingsRequest
בקשת הודעה ל-method GetShippingSetting
.
שדות | |
---|---|
name |
חובה. השם של הגדרת המשלוח שצריך לאחזר. פורמט: |
GetTermsOfServiceAgreementStateRequest
בקשת הודעה ל-method GetTermsOfServiceAgreementState
.
שדות | |
---|---|
name |
חובה. שם המשאב של גרסת התנאים וההגבלות. פורמט: |
GetTermsOfServiceRequest
בקשת הודעה ל-method GetTermsOfService
.
שדות | |
---|---|
name |
חובה. שם המשאב של גרסת התנאים וההגבלות. פורמט: |
GetUserRequest
בקשת הודעה ל-method GetUser
.
שדות | |
---|---|
name |
חובה. שם המשתמש שצריך לאחזר. פורמט: ניתן גם לאחזר את המשתמש התואם למתקשר באמצעות |
כותרות
רשימה לא ריקה של כותרות של שורות או עמודות בטבלה. יש להגדיר רק אחד מהערכים prices
, weights
, num_items
, postal_code_group_names
או location
.
שדות | |
---|---|
prices[] |
חובה. רשימת גבולות עליון של מחיר הזמנה כולל. ערך המחיר האחרון יכול להיות אינסוף אם מגדירים את הערך amount_micros = -1. לדוגמה |
weights[] |
חובה. רשימת גבולות עליון של משקל ההזמנה כולל. הערך של המשקל האחרון יכול להיות אינסוף על ידי הגדרת הערך amount_micros = -1. לדוגמה, |
number_of_items[] |
חובה. רשימה של גבולות עליון מספר כולל של פריטים. הערך האחרון יכול להיות |
postal_code_group_names[] |
חובה. רשימת השמות של קבוצות הדואר. הערך האחרון יכול להיות |
locations[] |
חובה. רשימה של קבוצות של מזהי מיקומים. השדה לא יכול להיות ריק. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות. |
דף הבית
דף הבית של חנות.
שדות | |
---|---|
name |
מזהה. שם המשאב בדף הבית של החנות. פורמט: |
claimed |
פלט בלבד. האם נתבעה בעלות על דף הבית. מידע נוסף זמין בכתובת https://support.google.com/merchants/answer/176793. |
uri |
חובה. ה-URI (בדרך כלל כתובת URL) של דף הבית של החנות. |
InsertShippingSettingsRequest
בקשת הודעה ל-method InsertShippingSetting
.
שדות | |
---|---|
parent |
חובה. החשבון שאליו יתווסף המוצר הזה. פורמט: accounts/{account} |
shipping_setting |
חובה. הגרסה החדשה של החשבון. |
ListAccountIssuesRequest
בקשת הודעה ל-method ListAccountIssues
.
שדות | |
---|---|
parent |
חובה. ההורה שהוא הבעלים של אוסף הבעיות הזה. פורמט: |
page_size |
זה שינוי אופציונלי. המספר המקסימלי של בעיות שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא צויין ערך, יוחזרו 50 משתמשים לכל היותר. הערך המקסימלי הוא 100; ערכים מעל 100 יקובצו ל-100 |
page_token |
זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב- במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל- |
language_code |
זה שינוי אופציונלי. הבעיות בתשובה יכללו שדות שאנשים יכולים לקרוא בשפה הנתונה. הפורמט הוא BCP-47, כמו |
time_zone |
זה שינוי אופציונלי. אזור הזמן IANA משמש להתאמת הזמנים לשוק המקומי בשדות שבני אדם יכולים לקרוא. לדוגמה, 'America/Los_Angeles'. אם המדיניות לא מוגדרת, הערך America/Los_Angeles יהיו בשימוש. |
ListAccountIssuesResponse
הודעת תשובה לשיטה ListAccountIssues
.
שדות | |
---|---|
account_issues[] |
הבעיות מהחשבון שצוין. |
next_page_token |
אסימון, שניתן לשלוח בתור |
ListAccountsRequest
בקשת הודעה ל-method ListAccounts
.
שדות | |
---|---|
page_size |
זה שינוי אופציונלי. מספר החשבונות המקסימלי שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא צוין, יוחזרו 250 חשבונות לכל היותר. הערך המקסימלי הוא 500; ערכים מעל 500 מועתקים ל-500. |
page_token |
זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב- במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל- |
filter |
זה שינוי אופציונלי. הפונקציה מחזירה רק חשבונות שתואמים למסנן. פרטים נוספים זמינים בחומר העזר בנושא תחביר של מסננים. |
ListAccountsResponse
הודעת תשובה לשיטה ListAccounts
.
שדות | |
---|---|
accounts[] |
החשבונות שתואמים ל |
next_page_token |
אסימון, שניתן לשלוח בתור |
ListOnlineReturnPoliciesRequest
בקשת הודעה ל-method ListOnlineReturnPolicies
.
שדות | |
---|---|
parent |
חובה. חשבון המוכר/ת שלגביו צריכה להופיע מדיניות החזרת מוצרים. פורמט: |
page_size |
זה שינוי אופציונלי. המספר המקסימלי של |
page_token |
זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב- במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל- |
ListOnlineReturnPoliciesResponse
הודעת תשובה לשיטה ListOnlineReturnPolicies
.
שדות | |
---|---|
online_return_policies[] |
מדיניות החזרת המוצרים שאוחזרה. |
next_page_token |
אסימון, שניתן לשלוח בתור |
ListProgramsRequest
הודעת בקשה לשיטה ListPrograms.
שדות | |
---|---|
parent |
חובה. שם החשבון שעבורו רוצים לאחזר את כל התוכניות. פורמט: |
page_size |
זה שינוי אופציונלי. המספר המקסימלי של תוכניות שצריך להחזיר בתגובה אחת. אם לא צוין (או 0), ייעשה שימוש בגודל ברירת מחדל של 1,000. הערך המקסימלי הוא 1,000; ערכים מעל 1000 יקובצו ל-1000. |
page_token |
זה שינוי אופציונלי. אסימון המשך, שהתקבל מקריאה קודמת של |
ListProgramsResponse
הודעת תגובה לשיטת ListPrograms.
שדות | |
---|---|
programs[] |
התוכניות של החשבון הנתון. |
next_page_token |
אסימון שאפשר לשלוח בתור |
ListRegionsRequest
בקשת הודעה ל-method ListRegions
.
שדות | |
---|---|
parent |
חובה. החשבון שעבורו יש לרשום את האזורים. פורמט: |
page_size |
זה שינוי אופציונלי. מספר האזורים המקסימלי שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא צוין, יוחזרו 50 אזורים לכל היותר. הערך המקסימלי הוא 1,000; ערכים מעל 1000 יקובצו ל-1000. |
page_token |
זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב- במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל- |
ListRegionsResponse
הודעת תשובה לשיטה ListRegions
.
שדות | |
---|---|
regions[] |
האזורים של המוכר שצוין. |
next_page_token |
אסימון, שניתן לשלוח בתור |
ListSubAccountsRequest
בקשת הודעה ל-method ListSubAccounts
.
שדות | |
---|---|
provider |
חובה. חשבון ההורה. פורמט: |
page_size |
זה שינוי אופציונלי. מספר החשבונות המקסימלי שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא צוין, יוחזרו 250 חשבונות לכל היותר. הערך המקסימלי הוא 500; ערכים מעל 500 מועתקים ל-500. |
page_token |
זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב- במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל- |
ListSubAccountsResponse
הודעת תשובה לשיטה ListSubAccounts
.
שדות | |
---|---|
accounts[] |
החשבונות שחשבון ההורה הרלוונטי משמש אותם כאתר אגרגטור. |
next_page_token |
אסימון, שניתן לשלוח בתור |
ListUsersRequest
בקשת הודעה ל-method ListUsers
.
שדות | |
---|---|
parent |
חובה. ההורה שהוא הבעלים של אוסף המשתמשים הזה. פורמט: |
page_size |
זה שינוי אופציונלי. המספר המקסימלי של משתמשים שיחזרו. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא צויין ערך, יוחזרו 50 משתמשים לכל היותר. הערך המקסימלי הוא 100; ערכים מעל 100 יקובצו ל-100 |
page_token |
זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב- במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל- |
ListUsersResponse
הודעת תשובה לשיטה ListUsers
.
שדות | |
---|---|
users[] |
המשתמשים מהחשבון שצוין. |
next_page_token |
אסימון, שניתן לשלוח בתור |
LocationIdSet
רשימה של קבוצות של מזהי מיקומים. השדה לא יכול להיות ריק. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.
שדות | |
---|---|
location_ids[] |
חובה. רשימה של מזהי מיקומים שאינה ריקה. על כל המיקומים להיות מאותו סוג מיקום (לדוגמה, מדינה). |
MinimumOrderValueTable
טבלה של ערכי ההזמנה המינימליים לכל חנות עבור סוג מילוי ההזמנות לאיסוף.
שדות | |
---|---|
store_code_set_with_movs[] |
חובה. רשימה של קבוצות של קודי חנויות שיש להן ערך הזמנה מינימלי (MOV) זהה. צריך להזין לפחות שתי קבוצות והשנייה צריכה להיות ריקה, כדי לציין 'MOV לכל שאר החנויות'. כל קוד חנות יכול להופיע פעם אחת בלבד בכל הקבוצות. לכל המחירים בשירות מסוים צריך להיות מטבע זהה. |
StoreCodeSetWithMov
רשימה של קבוצות של קודי חנויות שיש להן ערך הזמנה מינימלי זהה. צריך להזין לפחות שתי קבוצות והשנייה צריכה להיות ריקה, כדי לציין 'MOV לכל שאר החנויות'. כל קוד חנות יכול להופיע פעם אחת בלבד בכל הקבוצות. לכל המחירים בשירות מסוים צריך להיות מטבע זהה.
שדות | |
---|---|
store_codes[] |
זה שינוי אופציונלי. רשימה של קודי חנויות ייחודיים, או ריקה להכול. |
value |
ערך ההזמנה המינימלי בחנויות הנתונות. |
OnlineReturnPolicy
אובייקט Online return policy (מדיניות החזרת מוצרים אונליין). ההגדרה הזו משמשת כרגע לייצוג מדיניות החזרת מוצרים של מודעות ותוכניות של כרטיסי מוצר חינמיים.
שדות | |
---|---|
name |
מזהה. שם המשאב |
return_policy_id |
פלט בלבד. מזהה מדיניות החזרת המוצרים שנוצר על ידי Google. |
label |
השדה הזה מייצג את התווית הייחודית שהוגדרה על ידי המשתמש של מדיניות החזרת המוצרים. חשוב לציין שאי אפשר להשתמש באותה תווית במדיניות החזרת מוצרים שונה לאותה מדינה. המדיניות תסומן באופן אוטומטי בתווית 'ברירת המחדל', אלא אם למוצר צוין מאפיין ספציפי של תווית. כדי להקצות מדיניות החזרת מוצרים מותאמת אישית לקבוצות מוצרים מסוימות, צריך לפעול לפי ההוראות שמפורטות בתווית של מדיניות החזרת מוצרים. התווית יכולה להכיל עד 50 תווים. |
countries[] |
מדינות המכירה שבהן חלה מדיניות החזרת המוצרים. הערכים צריכים להיות קוד ISO 3166 חוקי בן 2 אותיות. |
policy |
מדיניות החזרת המוצרים. |
restocking_fee |
עמלת החזרה למלאי שחלה על כל הקטגוריות של סיבות ההחזרה. אם הערך לא הוגדר, זה ייחשב כעמלת החזרה למלאי בחינם. |
return_methods[] |
מהן שיטות ההחזרה שבהן לקוחות יכולים להחזיר פריט. חובה להשאיר את הערך הזה ריק, אלא אם הסוג של מדיניות החזרת המוצרים הוא noReturns. |
item_conditions[] |
חובה למלא את תנאי הפריט שבהם אפשר להחזיר מוצרים, אלא אם סוג מדיניות החזרת המוצרים הוא 'noReturns'. |
return_shipping_fee |
דמי המשלוח להחזרת מוצר. יש להגדיר אותה רק כשהלקוח צריך להוריד ולהדפיס את תווית ההחזרה. |
return_policy_uri |
ה-URI של מדיניות החזרת המוצרים Google יכולה להשתמש בתכונה הזו כדי לבצע בדיקת שפיות למדיניות. חייבת להיות כתובת URL חוקית. |
accept_defective_only |
השדה הזה מציין אם המוכר מקבל רק מוצרים פגומים להחזרת מוצרים, והשדה הזה הוא חובה. |
process_refund_days |
השדה מציין את מספר הימים שנדרשים למוכרים כדי לעבד החזרים כספיים. השדה הוא אופציונלי. |
accept_exchange |
השדה הזה מציין אם המוכר מאפשר ללקוחות להחליף מוצרים, השדה הזה הוא חובה. |
ItemCondition
תנאי הפריטים הזמינים.
טיפוסים בני מנייה (enum) | |
---|---|
ITEM_CONDITION_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה לא בשימוש. |
NEW |
חדש. |
USED |
בשימוש. |
מדיניות
כללי המדיניות הזמינים.
שדות | |
---|---|
type |
סוג המדיניות. |
days |
מספר הימים שאפשר להחזיר פריטים אחרי המסירה. יום אחד מוגדר כ-24 שעות אחרי חותמת הזמן של המסירה. נדרש עבור החזרות של |
סוג
הסוגים של מדיניות החזרת המוצרים.
טיפוסים בני מנייה (enum) | |
---|---|
TYPE_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה לא בשימוש. |
NUMBER_OF_DAYS_AFTER_DELIVERY |
מספר הימים שבהם ההחזרה תקפה מרגע המסירה. |
NO_RETURNS |
אין אפשרות להחזיר מוצרים. |
LIFETIME_RETURNS |
וזה לא הכול! |
RestockingFee
עמלת החזרה למלאי. זה יכול להיות סכום קבוע או מיקרו-אחוז.
שדות | |
---|---|
שדה איחוד
|
|
fixed_fee |
עמלת החזרה למלאי קבועה. |
micro_percent |
אחוז מהמחיר הכולל במיליוניות השנייה. 15,000,000 פירושו שיחויבו 15% מהמחיר הכולל. |
ReturnMethod
השיטות הזמינות להחזרת מוצרים.
טיפוסים בני מנייה (enum) | |
---|---|
RETURN_METHOD_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה לא בשימוש. |
BY_MAIL |
החזרה בדואר. |
IN_STORE |
יש לחזור בחנות. |
AT_A_KIOSK |
החזרה בקיוסק. |
ReturnShippingFee
דמי המשלוח להחזרת מוצר. התשלום יכול להיות עמלה קבועה או בוליאני, כדי לציין שהלקוח משלם את עלות המשלוח בפועל.
שדות | |
---|---|
type |
סוג עמלת המשלוח להחזרת מוצר. |
fixed_fee |
סכום קבוע של עמלת משלוח להחזרת מוצר. הערך הזה רלוונטי רק כשהסוג הוא |
סוג
סוגי דמי משלוח להחזרת מוצרים.
טיפוסים בני מנייה (enum) | |
---|---|
TYPE_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה לא בשימוש. |
FIXED |
דמי המשלוח להחזרת מוצר הם ערך קבוע. |
CUSTOMER_PAYING_ACTUAL_FEE |
הלקוחות ישלמו את דמי המשלוח בפועל להחזרת המוצר. |
PhoneVerificationState
מצב האימות של מספר הטלפון.
טיפוסים בני מנייה (enum) | |
---|---|
PHONE_VERIFICATION_STATE_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה לא בשימוש. |
PHONE_VERIFICATION_STATE_VERIFIED |
מספר הטלפון מאומת. |
PHONE_VERIFICATION_STATE_UNVERIFIED |
הטלפון לא מאומת |
תוכנית
מגדיר את ההשתתפות בתוכנית נתונה של החשבון שצוין.
התוכניות מספקות מנגנון להוספת פונקציונליות לחשבונות המוכרים. דוגמה אופיינית לכך היא התוכנית כרטיסי מוצר חינמיים, שמאפשרת להציג ב-Google בחינם מוצרים מחנות של מוֹכר.
שדות | |
---|---|
name |
מזהה. שם המשאב של התוכנה. פורמט: |
documentation_uri |
פלט בלבד. כתובת ה-URL של דף עזרה ב-Merchant Center שמתאר את התוכנית. |
state |
פלט בלבד. סטטוס ההשתתפות של החשבון בתוכנית. |
active_region_codes[] |
פלט בלבד. האזורים שבהם החשבון משתתף באופן פעיל בתוכנית. אזורים פעילים מוגדרים כאזורים שבהם מתקיימים כל דרישות התוכנית שמשפיעות על האזורים. קודי האזורים מוגדרים באמצעות CLDR. במדינה הזו התוכנית חלה באופן ספציפי על מדינה זו או על |
unmet_requirements[] |
פלט בלבד. הדרישות שהחשבון עדיין לא עמד בהן ומשפיעות על ההשתתפות בתוכנית. |
דרישה
מגדיר דרישה שצוינה להשתתפות בתוכנית.
שדות | |
---|---|
title |
פלט בלבד. שם הדרישה. |
documentation_uri |
פלט בלבד. כתובת ה-URL של דף עזרה שמתאר את הדרישה. |
affected_region_codes[] |
פלט בלבד. האזורים שמושפעים כרגע מהדרישה הזו לא מתקיימים. קודי האזורים מוגדרים באמצעות CLDR. במדינה הזו התוכנית חלה באופן ספציפי על מדינה זו או על |
מדינה
מצבים אפשריים להשתתפות בתוכנית של החשבון.
טיפוסים בני מנייה (enum) | |
---|---|
STATE_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה לא בשימוש. |
NOT_ELIGIBLE |
החשבון לא עומד בדרישות ההשתתפות בתוכנית. |
ELIGIBLE |
החשבון עומד בדרישות להשתתפות בתוכנית. |
ENABLED |
התוכנית מופעלת עבור החשבון. |
RateGroup
הגדרות של קבוצת תעריפי משלוחים. רק התג האחרון יכול להכיל applicable_shipping_labels
ריק, כלומר 'כל השאר'. הערכים מסוג 'applicable_shipping_labels
' האחרים לא יכולים לחפוף.
שדות | |
---|---|
applicable_shipping_labels[] |
חובה. רשימה של תוויות משלוח שמגדירות את המוצרים שעליהם חלה קבוצת התעריפים הזו. זהו הבדל: רק אחת מהתוויות צריכה להתאים כדי שקבוצת התעריפים תחול. השדה הזה יכול להיות ריק רק לקבוצת התעריפים האחרונה של שירות. |
subtables[] |
זה שינוי אופציונלי. רשימה של טבלאות משנה שיש להן הפניה אל |
carrier_rates[] |
זה שינוי אופציונלי. רשימה של תעריפים של חברות תובלה שאפשר להתייחס אליהם לפי |
single_value |
הערך של קבוצת התעריפים (למשל, תעריף קבוע של 40 ש"ח). אפשר להגדיר רק אם המדיניות |
main_table |
טבלה שמגדירה את קבוצת התעריפים, במקרים שבהם הביטוי |
name |
זה שינוי אופציונלי. השם של קבוצת התעריפים. אם מוגדר ערך ייחודי בשירות המשלוחים. |
אזור
מייצג אזור גיאוגרפי שאפשר להשתמש בו כיעד גם בשירות RegionalInventory
וגם בשירות ShippingSettings
. אפשר להגדיר אזורים כאוספים של מספרי מיקוד, או במדינות מסוימות באמצעות טירגוטים גיאוגרפיים מוגדרים מראש. מידע נוסף זמין במאמר הגדרת אזורים .
שדות | |
---|---|
name |
מזהה. שם המשאב של האזור. פורמט: |
postal_code_area |
זה שינוי אופציונלי. רשימת מיקודים שמגדירה את אזור האזור. |
geotarget_area |
זה שינוי אופציונלי. רשימה של יעדים גיאוגרפיים שמגדירים את אזור האזור. |
regional_inventory_eligible |
פלט בלבד. שדה זה מציין אם האזור עומד בדרישות לשימוש בהגדרת המלאי האזורי. |
shipping_eligible |
פלט בלבד. שדה זה מציין אם האזור עומד בדרישות לשימוש בהגדרת שירותי המשלוחים. |
display_name |
זה שינוי אופציונלי. השם המוצג של האזור. |
GeoTargetArea
רשימה של יעדים גיאוגרפיים שמגדירים את אזור האזור.
שדות | |
---|---|
geotarget_criteria_ids[] |
חובה. רשימה של מזהי מיקומים שאינה ריקה. על כל המיקומים להיות מאותו סוג מיקום (לדוגמה, מדינה). |
PostalCodeArea
רשימת מיקודים שמגדירה את אזור האזור. הערה: אפשר לגשת לכל האזורים שהוגדרו באמצעות מספרי מיקוד דרך המשאב ShippingSettings.postalCodeGroups
של החשבון.
שדות | |
---|---|
region_code |
חובה. קוד האזור במאגר CLDR או המדינה שעליה חלה קבוצת המיקוד. |
postal_codes[] |
חובה. טווח של מספרי מיקוד. |
PostalCodeRange
טווח של מספרי מיקוד שמגדיר את אזור האזור.
שדות | |
---|---|
begin |
חובה. מיקוד או תבנית של קידומת הטופס* שמציין את הגבול התחתון הכולל של הטווח שמגדיר את האזור. ערכים לדוגמה: |
end |
זה שינוי אופציונלי. מיקוד או תבנית בצורה |
חובה
תיאור התנאים וההגבלות הנדרשים לאישור.
שדות | |
---|---|
terms_of_service |
את termsOfService שיש לאשר. |
tos_file_uri |
כתובת ה-URL המלאה של קובץ התנאים וההגבלות. השדה הזה זהה לשדה TermsOfService.file_uri, הוא מתווסף כאן מטעמי נוחות בלבד. |
RetrieveForApplicationTermsOfServiceAgreementStateRequest
בקשת הודעה ל-method RetrieveForApplicationTermsOfServiceAgreementState
.
שדות | |
---|---|
parent |
חובה. החשבון שעבורו מקבלים את הפורמט של התנאים וההגבלות הסכם מצב: |
RetrieveLatestTermsOfServiceRequest
בקשת הודעה ל-method RetrieveLatestTermsOfService
.
שדות | |
---|---|
region_code |
קוד האזור לפי ההגדרה של CLDR. מדובר במדינה שבה התנאים וההגבלות חלים באופן ספציפי על אותה מדינה, או אם התנאים וההגבלות חלים בכל העולם, או קוד 001. |
kind |
סוג הגרסה של התנאים וההגבלות האלה. |
שורה
מוסיפים רשימת תאים.
שדות | |
---|---|
cells[] |
חובה. רשימת התאים שמרכיבים את השורה. האורך של הטבלה צריך להיות זהה לזה של |
שירות
שירות משלוחים.
שדות | |
---|---|
delivery_countries[] |
חובה. קוד הטריטוריה של מאגר ה-CLDR של המדינות שבהן השירות חל. |
rate_groups[] |
זה שינוי אופציונלי. הגדרות של קבוצת תעריפי משלוחים. רק התג האחרון יכול להכיל |
loyalty_programs[] |
זה שינוי אופציונלי. מועדוני לקוחות ששירות המשלוחים הזה מוגבל אליהם. |
service_name |
חובה. שם השירות שמופיע בניסוח חופשי. חייב להיות ייחודי בחשבון היעד. |
active |
חובה. ערך בוליאני שחושף את הסטטוס הפעיל של שירות המשלוחים. |
currency_code |
קוד ה-CLDR של המטבע שעליו השירות הזה חל. חייב להיות זהה למחירים בקבוצות תעריפים. |
delivery_time |
חובה. הזמן שהוקדש להיבטים שונים, מרגע קבלת המוצר ועד למסירת המוצר. |
shipment_type |
סוג המיקומים שאליהם השירות הזה מבצע הזמנות. |
minimum_order_value |
ערך הזמנה מינימלי לשירות הזה. אם האפשרות מוגדרת, המשמעות היא שהלקוחות יצטרכו להוציא לפחות סכום זה. לכל המחירים בשירות מסוים צריך להיות מטבע זהה. לא ניתן להגדיר יחד עם ערך מינימלי_order_value_table. |
minimum_order_value_table |
טבלה של ערכי ההזמנה המינימליים לכל חנות עבור סוג מילוי ההזמנות לאיסוף. לא ניתן להגדיר יחד עם ערך מינימלי_order_value. |
store_config |
רשימה של החנויות שמהן נשלחים המוצרים. תקף רק לסוג משלוח מקומי. |
LoyaltyProgram
מועדון לקוחות שסופק על ידי מוכר.
שדות | |
---|---|
loyalty_program_tiers[] |
זה שינוי אופציונלי. רמת מועדון הלקוחות של שירות המשלוחים הזה. |
program_label |
תווית מועדון הלקוחות שנוצרה בהגדרות של מועדון הלקוחות ב-Merchant Center. מאפיין המשנה הזה מאפשר ל-Google למפות את מועדון הלקוחות למוצרים כשירים. |
LoyaltyProgramTiers
קבוצת משנה של מועדון לקוחות של מוכר.
שדות | |
---|---|
tier_label |
מאפיין המשנה לתווית הרמה [tier_label] יוצר הבדל בין הטבות ברמת המוצר ברמות שונות. הערך הזה מוגדר גם בהגדרות התוכנית ב-Merchant Center, והוא נדרש לשינויים במקור הנתונים גם אם במועדון הלקוחות שלכם יש רק רמה אחת. |
ShipmentType
סוג שירות המשלוחים.
טיפוסים בני מנייה (enum) | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
בשירות הזה לא צוין סוג משלוח. |
DELIVERY |
בשירות הזה אפשר לשלוח הזמנות לכתובת שהלקוח בחר. |
LOCAL_DELIVERY |
בשירות הזה אפשר לשלוח הזמנות לכתובת שהלקוח בחר. ההזמנה נשלחת מחנות מקומית בקרבת מקום. |
COLLECTION_POINT |
בשירות הזה אפשר לשלוח הזמנות לכתובת שהלקוח בחר. ההזמנה נשלחת מנקודת איסוף. |
StoreConfig
רשימה של החנויות שמהן נשלחים המוצרים. תקף רק לסוג משלוח מקומי.
שדות | |
---|---|
store_codes[] |
זה שינוי אופציונלי. רשימה של קודי חנויות שמספקים משלוח מקומי. אם השדה ריק, הערך |
store_service_type |
מאפיין זה מציין אם כל החנויות או החנויות הנבחרות שצוינו על ידי המוכר הזה מספקות משלוח מקומי. |
cutoff_config |
הגדרות שקשורות למסירה מקומית מסתיימות באותו היום. |
service_radius |
רדיוס מסירה מקסימלי. צריך לעשות זאת רק עבור סוג משלוח מקומי. |
CutoffConfig
הגדרות שקשורות למסירה מקומית מסתיימות באותו היום.
שדות | |
---|---|
local_cutoff_time |
השעה שבה המשלוח המקומי מסתיים באותו יום. |
store_close_offset_hours |
תקף רק למילוי הזמנות במשלוח מקומי. המועד האחרון להזמנה מייצג את מספר השעות לפני סגירת החנות. בלעדי באופן הדדי עם |
no_delivery_post_cutoff |
מוכרים יכולים לבטל את ההסכמה להצגת משלוח מקומי תוך יום אחד ומעלה אם יש להם שירות משלוחים שמוגדר למסירה מקומית תוך n ימים. לדוגמה, אם בשירות המשלוחים מוגדר מסירה ביום הקנייה ומועד הסיום חלף, אם הערך בשדה הזה הוא |
LocalCutoffTime
השעה שבה המשלוח המקומי מסתיים באותו יום.
שדות | |
---|---|
hour |
אפשר לבצע הזמנות עם משלוח מקומי לפי שעה עד לסיום הטיפול באותו יום. |
minute |
הזמנות של משלוח מקומי לפי דקות חייבות להתבצע עד לאותו יום. |
StoreServiceType
מציין אם כל החנויות או החנויות הנבחרות שצוינו על ידי המוכר מספקות משלוח מקומי.
טיפוסים בני מנייה (enum) | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
לא צוין סוג שירות החנות. |
ALL_STORES |
שדה זה מציין אם כל החנויות – הקיימות והעתידיות – שמספקות משלוח מקומי. |
SELECTED_STORES |
מציין שרק החנויות שמופיעות בstore_codes עומדות בדרישות למשלוח מקומי. |
ShippingSettings
[הגדרת המשלוח]((https://support.google.com/merchants/answer/6069284) של חשבון המוכר/ת.
שדות | |
---|---|
name |
מזהה. שם המשאב של הגדרת המשלוח. פורמט: |
services[] |
זה שינוי אופציונלי. רשימת השירותים של חשבון היעד. |
warehouses[] |
זה שינוי אופציונלי. רשימה של מחסנים שאפשר להתייחס אליהם ב- |
etag |
חובה. השדה הזה משמש למניעת בעיה אסינכרונית. צריך לוודא שנתוני הגדרות המשלוח לא השתנו בין קבלת שיחה להוספת שיחה. המשתמש צריך לבצע את השלבים הבאים:
|
טבלה
טבלה שמגדירה את קבוצת התעריפים, במקרים שבהם הביטוי single_value
לא מספיק מפורש.
שדות | |
---|---|
rows[] |
חובה. רשימת השורות שמהן מורכב הטבלה. האורך חייב להיות זהה לזה של |
name |
שם הטבלה. חובה לטבלאות משנה, והמערכת מתעלמת ממנו עבור הטבלה הראשית. |
row_headers |
חובה. כותרות של שורות הטבלה. |
column_headers |
הכותרות של עמודות הטבלה. אופציונלי: אם היא לא מוגדרת, יש לטבלה מאפיין אחד בלבד. |
TaxRule
סוג ההמרה הראשי
אחוז מיקרו : 100% = 1 000 000 ו-1% = 10 000 לא יכול להיות שלילי.
מידע על זיקה לצורכי מס ופרמטרים קשורים שרלוונטיים להזמנות שנמסרו לאזור שמכוסה על ידי אדמין מס אחד. מכשיר Nexus נוצר כשמוכר מבצע עסקים באזור שמנוהל על ידי מנהל המס (אפשר להגדיר זיקה לצורכי מס רק למדינות בארה"ב). אם למוכר יש זיקה במדינה בארה"ב, המוכר צריך לשלם מס לכל רשויות המס שקשורות ליעד המשלוח. המזהה הבא : 8
שדות | |
---|---|
region_code |
קוד האזור שבו הכלל הזה חל |
shipping_taxed |
אם המדיניות מוגדרת, המערכת תגבה מס על המשלוח (בשיעור זהה לתעריף של המוצר) כשמסירים מוצרים לאזור של האדמין. אפשר להגדיר את הערך רק במדינות בארה"ב ללא קטגוריה. |
effective_time_period |
חובה. התקופה שבה הכלל ייכנס לתוקף. אם משך הזמן לא רשום ב-Effective_time, אז הוא פתוח עם סיום בעתיד. ההתחלה של התקופה הזו כוללת, והיא לא כוללת את הסיום. |
שדה איחוד location . יש לתאר את המיקום באמצעות טווח מיקוד או מזהה קריטריון. location יכול להיות רק אחת מהאפשרויות הבאות: |
|
location_id |
הערך admin_id או criteria_id של האזור שבו הכלל הזה חל. |
post_code_range |
טווח מספרי המיקוד שבהם הכלל הזה חל. |
שדה איחוד rate_calculation . מהי הדרך שבה מחשבים את שיעור המס על משלוחים לאזור של האדמין הזה. אפשר להגדיר זאת רק במדינות בארה"ב. rate_calculation יכול להיות רק אחת מהאפשרויות הבאות: |
|
use_google_rate |
תעריף שתלוי במיקום המשלוח: אם למוכר יש זיקה לצורכי מס במדינה תואמת בארה"ב, יתווספו תעריפים מרשויות שיש להן סמכות שיפוט מעל האזור למשלוחים. |
self_specified_rate_micros |
תעריף קבוע שמצוין במיליוניות השנייה, כאשר 100% = 1_000_000. מתאים למדינות לפי המוצא. |
TaxPostalCodeRange
טווח של מספרי מיקוד שמגדיר את האזור.
שדות | |
---|---|
start |
חובה. תחילת טווח המיקוד, שהוא גם הקטן ביותר בטווח. |
end |
סוף טווח המיקודים. אם לא תציינו ערך, תהיה אותה ערך כמו 'התחלה'. |
TermsOfService
TermsOfService
.
שדות | |
---|---|
name |
מזהה. שם המשאב של גרסת התנאים וההגבלות. פורמט: |
region_code |
קוד האזור לפי ההגדרה של CLDR. מדובר במדינה שבה התנאים וההגבלות חלים באופן ספציפי על אותה מדינה, או |
kind |
סוג הגרסה של התנאים וההגבלות האלה. |
external |
אם הגרסה הזו של התנאים וההגבלות היא חיצונית. אפשר לאשר גרסאות חיצוניות של תנאים והגבלות רק בתהליכים חיצוניים, ולא ישירות על ידי המוכר דרך ממשק משתמש או API. |
file_uri |
URI לקובץ התנאים וההגבלות שצריך להציג כדי לחתום על משתמשים. |
TermsOfServiceAgreementState
המשאב הזה מייצג את מצב ההסכם של חשבון מסוים ואת סוג התנאים וההגבלות. המדינה צריכה להיות:
- אם המוכר אישר את התנאים וההגבלות: השדה מאושר יאוכלס. אחרת, השדה יהיה ריק.
- אם המוכר חייב לחתום על תנאים והגבלות: שדה חובה יאוכלס. אחרת, השדה יהיה ריק.
הערה: אפשר לכלול גם את שדה חובה וגם את מאושר. במקרה כזה, תאריך התפוגה של התנאים וההגבלות של accepted
יוגדר בשדה valid_until. עליך לאשר את התנאים וההגבלות של required
לפני valid_until
כדי שהחשבון ימשיך להיות בעל הסכם תקף. כשאנחנו מקבלים תנאים והגבלות חדשים, אנחנו מצפים מצדדים שלישיים להציג את הטקסט שמשויך להסכם התנאים וההגבלות הנתון (כתובת ה-URL לקובץ שמכיל את הטקסט תתווסף בהודעה הנדרשת שבהמשך כ-tos_file_uri. כדי לאשר בפועל את התנאים וההגבלות, צריך להפעיל את ההגדרה 'אישור' במשאב TermsOfService.
שדות | |
---|---|
name |
מזהה. שם המשאב של גרסת התנאים וההגבלות. פורמט: |
region_code |
קוד האזור כפי שמוגדר על ידי https://cldr.unicode.org/. זוהי המדינה שעליה חלה המדינה הנוכחית. |
terms_of_service_kind |
סוג התנאים וההגבלות המשויכים לגרסה המסוימת. |
accepted |
התנאים וההגבלות הקבילים מהסוג הזה ובקוד האזור המשויך |
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[] |
חובה. רשימה של שמות האזורים |
transit_time_labels[] |
חובה. רשימה של תוויות זמן הובלה. הערך האחרון יכול להיות |
rows[] |
חובה. אם קיימת רק קבוצת מאפיינים אחת של |
TransitTimeRow
אם קיימת רק קבוצת מאפיינים אחת של postal_code_group_names
או transit_time_labels
, יש מספר שורות שכל אחת מהן מכילה ערך אחד עבור המאפיין הזה. אם יש שני מאפיינים, כל שורה תואמת למאפיין postal_code_group_names
, והעמודות (ערכים) תואמות למאפיין transit_time_labels
.
שדות | |
---|---|
values[] |
חובה. טווח זמן ההובלה (מינימום) בימי עסקים. |
TransitTimeValue
טווח זמן ההובלה (מינימום) בימי עסקים.
שדות | |
---|---|
min_transit_days |
טווח זמן ההובלה המינימלי בימי עסקים. 0 פירושו מסירה ביום הקנייה, 1 פירושו משלוח ביום המחרת. |
max_transit_days |
חייב להיות גדול מ- |
UnclaimHomepageRequest
בקשת הודעה ל-method UnclaimHomepage
.
שדות | |
---|---|
name |
חובה. שם דף הבית שרוצים לבטל את תביעת הבעלות עליו. פורמט: |
UpdateAccountRequest
בקשת הודעה ל-method UpdateAccount
.
שדות | |
---|---|
account |
חובה. הגרסה החדשה של החשבון. |
update_mask |
חובה. רשימת השדות שצריך לעדכן. |
UpdateAccountTaxRequest
שליחת בקשה לעדכון הגדרות המס
שדות | |
---|---|
account_tax |
חובה. הגדרת המס שתעודכן |
update_mask |
רשימת השדות לעדכון |
UpdateBusinessIdentityRequest
בקשת הודעה ל-method UpdateBusinessIdentity
.
שדות | |
---|---|
business_identity |
חובה. הגרסה החדשה של זהות העסק. |
update_mask |
חובה. רשימת השדות שצריך לעדכן. |
UpdateBusinessInfoRequest
בקשת הודעה ל-method UpdateBusinessInfo
.
שדות | |
---|---|
business_info |
חובה. הגרסה החדשה של פרטי העסק. |
update_mask |
חובה. רשימת השדות שצריך לעדכן. |
UpdateEmailPreferencesRequest
בקשת הודעה לשיטת UpdateEmailPreferences.
שדות | |
---|---|
email_preferences |
חובה. העדפות האימייל לעדכון. |
update_mask |
חובה. רשימת השדות שצריך לעדכן. |
UpdateHomepageRequest
בקשת הודעה ל-method UpdateHomepage
.
שדות | |
---|---|
homepage |
חובה. הגרסה החדשה של דף הבית. |
update_mask |
חובה. רשימת השדות שצריך לעדכן. |
UpdateRegionRequest
בקשת הודעה ל-method UpdateRegion
.
שדות | |
---|---|
region |
חובה. האזור המעודכן. |
update_mask |
זה שינוי אופציונלי. מסכת שדות שמופרדים בפסיקים שמציינת את השדות שצריך לעדכן. דוגמה: |
UpdateUserRequest
בקשת הודעה ל-method UpdateUser
.
שדות | |
---|---|
user |
חובה. הגרסה החדשה של המשתמש. אפשר להשתמש ב- |
update_mask |
חובה. רשימת השדות שצריך לעדכן. |
משתמש
שדות | |
---|---|
name |
מזהה. שם המשאב של המשתמש. פורמט: אפשר להשתמש ב- |
state |
פלט בלבד. המצב של המשתמש. |
access_rights[] |
זה שינוי אופציונלי. הרשאות הגישה שיש למשתמש. |
מדינה
המצבים האפשריים של המשתמש.
טיפוסים בני מנייה (enum) | |
---|---|
STATE_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה לא בשימוש. |
PENDING |
המשתמש ממתין לאישור. במצב הזה, המשתמש צריך קודם לאשר את ההזמנה לפני שהוא מבצע פעולות אחרות. |
VERIFIED |
המשתמש מאומת. |
ערך
הערך היחיד של קבוצת תעריפים או הערך של התא בטבלת קבוצת תעריפים. יש להגדיר רק אחד מהערכים no_shipping
, flat_rate
, price_percentage
, carrier_rateName
, subtable_name
.
שדות | |
---|---|
no_shipping |
אם הערך הוא True, לא ניתן לשלוח את המוצר. הערך צריך להיות True כשמגדירים, רק אם לא מוגדרים כל שאר השדות. |
flat_rate |
תעריף קבוע. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות. |
price_percentage |
אחוז מהמחיר שמיוצג כמספר בסימון עשרוני (לדוגמה, |
carrier_rate |
השם של תעריף של חברת תובלה שמתייחס לתעריף של חברת תובלה שמוגדר באותה קבוצת תעריפים. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות. |
subtable |
השם של טבלת משנה. אפשר להגדיר אותן רק בתאים בטבלה (לדוגמה לא לערכים בודדים) ורק אם כל שאר השדות לא הוגדרו. |
מחסן
מחסן לאספקה, שבו מאחסנים ומטפלים במלאי. התג הבא: 7
שדות | |
---|---|
name |
חובה. שם המחסן. חייב להיות ייחודי בחשבון. |
shipping_address |
חובה. הכתובת למשלוח של המחסן. |
cutoff_time |
חובה. השעה האחרונה ביום שבה אפשר לאשר את ההזמנה ולהתחיל לעבד אותה. הזמנות שיבוצעו מאוחר יותר יטופלו ביום הבא. השעה מבוססת על המיקוד של המחסן. |
handling_days |
חובה. מספר הימים שנדרשים למחסן הזה כדי לארוז ולשלוח פריט. מגדירים את המאפיין הזה ברמת המחסן, אבל אפשר לשנות אותו ברמת המוצר בהתאם למאפיינים של הפריט. |
business_day_config |
ימי העסקים במחסן. אם לא מגדירים את הערך, ברירת המחדל תהיה שני עד שישי. |
WarehouseBasedDeliveryTime
מציין שיש לחשב את זמן האספקה לכל מחסן (מיקום המוצא של המשלוח) על סמך ההגדרות של חברת התובלה שנבחרה. כשההגדרה הזו מוגדרת, לא צריך להגדיר שדה אחר שקשור לזמן הובלה ב-delivery_time
.
שדות | |
---|---|
carrier |
חובה. ספק, למשל |
carrier_service |
חובה. השירות של ספק הסלולר, למשל |
warehouse |
חובה. שם המחסן. הוא צריך להיות תואם לערך [warehouse][ShippingSetting.warehouses.name] |
WarehouseCutoffTime
השעה האחרונה ביום שבה אפשר לאשר את ההזמנה ולהתחיל לעבד אותה. הזמנות שיבוצעו מאוחר יותר יטופלו ביום הבא. השעה מבוססת על המיקוד של המחסן.
שדות | |
---|---|
hour |
חובה. השעה המאוחרת ביותר שבה צריך לבצע הזמנה כדי שהיא תעובד במחסן באותו יום. השעה מבוססת על אזור הזמן של המחסן. |
minute |
חובה. דקה של המועד האחרון להזמנה כדי שההזמנה תעובד באותו יום במחסן. הדקות מבוססות על אזור הזמן של המחסן. |