Package google.shopping.merchant.lfp.v1beta

אינדקס

• LfpInventoryService (ממשק)
• LfpSaleService (ממשק)
• LfpStoreService (ממשק)
• DeleteLfpStoreRequest (הודעה)
• GetLfpStoreRequest (הודעה)
• InsertLfpInventoryRequest (הודעה)
• InsertLfpSaleRequest (הודעה)
• InsertLfpStoreRequest (הודעה)
• LfpInventory (הודעה)
• LfpSale (הודעה)
• LfpStore (הודעה)
• LfpStore.StoreMatchingState (טיפוסים בני מנייה (enum))
• ListLfpStoresRequest (הודעה)
• ListLfpStoresResponse (הודעה)

LfpInventoryService

שירות לשותף LFP לשליחת נתוני מלאי בחנות מקומית עבור מוכר.

InsertLfpInventory
rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory) הוספת משאב LfpInventory לחשבון מוכר היעד הנתון. אם המשאב כבר קיים, הוא יוחלף. תוקף המלאי פג באופן אוטומטי אחרי 30 יום. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: https://www.googleapis.com/auth/content למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

LfpSaleService

שירות לשותף LFP לשליחת נתוני מכירות של מוכר.

InsertLfpSale
rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale) הוספת LfpSale למוכר הנתון. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: https://www.googleapis.com/auth/content למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

LfpStoreService

שירות לשותף LFP לשליחת חנויות מקומיות של מוכר.

DeleteLfpStore
rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty) מחיקת חנות של מוכר יעד. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: https://www.googleapis.com/auth/content למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

GetLfpStore
rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore) מאחזר מידע על חנות. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: https://www.googleapis.com/auth/content למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

InsertLfpStore
rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore) הוספת חנות למוכר היעד. אם כבר קיימת חנות עם אותו קוד חנות, היא תוחלף. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: https://www.googleapis.com/auth/content למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

ListLfpStores
rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse) רשימת החנויות של מוכר היעד, שצוינו על ידי המסנן ב-ListLfpStoresRequest. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: https://www.googleapis.com/auth/content למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

DeleteLfpStoreRequest

הודעת בקשה עבור שיטת DeleteLfpStore.

שדות
name	string חובה. שם החנות שרוצים למחוק עבור חשבון היעד של המוכר. פורמט: accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

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

שדות
name	string חובה. שם החנות שרוצים לאחזר. פורמט: accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

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

שדות
parent	string חובה. החשבון של ספק ה-LFP. פורמט: accounts/{account}
lfp_inventory	LfpInventory חובה. המלאי להוספה.

InsertLfpSaleRequest

הודעת בקשה עבור שיטת InsertLfpSale.

שדות
parent	string חובה. החשבון של ספק ה-LFP. פורמט: accounts/{lfp_partner}
lfp_sale	LfpSale חובה. המכירה להוספה.

InsertLfpStoreRequest

הודעת בקשה עבור השיטה InsertLfpStore.

שדות
parent	string חובה. פורמט החשבון של ספק ה-LFP: accounts/{account}
lfp_store	LfpStore חובה. החנות להוספה.

LfpInventory

מלאי בחנות מקומית עבור המוכר.

שדות
name	string פלט בלבד. מזהה. השם של המשאב LfpInventory. פורמט: accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}
target_account	int64 חובה. מספר חשבון Merchant Center של המוכר שעבורו רוצים לשלוח את המלאי.
store_code	string חובה. המזהה של החנות של המוכר. קוד החנות שהוזן דרך InsertLfpStore או קוד החנות בפרופיל העסק.
offer_id	string חובה. בלתי משתנה. מזהה ייחודי של המוצר. אם שולחים גם נתוני מלאי וגם נתוני מכירות עבור מוכר מסוים, המזהה הזה צריך להתאים לאותו מוצר. הערה: אם המוכר מוכר את אותו מוצר במצב חדש ובמצב משומש, לכל אחד מהמוצרים צריך להיות מזהה שונה.
region_code	string חובה. קוד הטריטוריה בקובץ ה-CLDR של המדינה שבה המוצר נמכר.
content_language	string חובה. קוד שפה בן שתי אותיות לפי תקן ISO 639-1 של הפריט.
price	Price זה שינוי אופציונלי. המחיר הנוכחי של המוצר.
availability	string חובה. זמינות המוצר בחנות הזו. ערכי מאפיינים קבילים מפורטים במפרט הנתונים של מלאי מוצרים בחנויות מקומיות
collection_time	Timestamp זה שינוי אופציונלי. השעה שבה המלאי נאסף. אם לא קובעים במדיניות הזו שום ערך, היא תוגדר לזמן שבו המלאי יישלח.
gtin	string זה שינוי אופציונלי. מספר הפריט המסחרי הגלובלי של המוצר.
quantity	int64 זה שינוי אופציונלי. כמות המוצר הזמינה בחנות הזו. חייב להיות גדול מ-0 או שווה לו.
pickup_method	string זה שינוי אופציונלי. שיטת האיסוף שנתמכת במוצר הזה. צריך לשלוח את השדה הזה יחד עם השדה pickupSla, אלא אם הערך הזה הוא 'not supported'. למידע על ערכי המאפיינים הקבילים, מומלץ לעיין במפרט הנתונים של מלאי המוצרים בחנויות המקומיות.
pickup_sla	string זה שינוי אופציונלי. התאריך הצפוי שבו ההזמנה תהיה מוכנה לאיסוף, ביחס לתאריך ההזמנה. יש לשלוח אותה יחד עם pickupMethod. למידע על ערכי המאפיינים הקבילים, מומלץ לעיין במפרט הנתונים של מלאי המוצרים בחנויות המקומיות.
feed_label	string זה שינוי אופציונלי. תווית הפיד של המוצר. אם לא קובעים במדיניות הזו שום הגדרה, ברירת המחדל היא regionCode.

LfpSale

מכירה של המוכר.

שדות
name	string פלט בלבד. מזהה. שם המשאב LfpSale. פורמט: accounts/{account}/lfpSales/{sale}
target_account	int64 חובה. מספר חשבון Merchant Center של המוכר שעבורו רוצים לשלוח את המכירה.
store_code	string חובה. המזהה של החנות של המוכר. המזהה storeCode נוסף דרך ה-API או דרך קוד החנות בפרופיל העסק.
offer_id	string חובה. מזהה ייחודי של המוצר. אם שולחים גם נתוני מלאי וגם נתוני מכירות עבור מוכר מסוים, המזהה הזה צריך להתאים לאותו מוצר. הערה: אם המוכר מוכר את אותו מוצר במצב חדש ובמצב משומש, לכל אחד מהמוצרים צריך להיות מזהה שונה.
region_code	string חובה. קוד הטריטוריה בקובץ ה-CLDR של המדינה שבה המוצר נמכר.
content_language	string חובה. קוד שפה בן שתי אותיות לפי תקן ISO 639-1 של הפריט.
gtin	string חובה. מספר הפריט המסחרי הגלובלי של המוצר שנמכר.
price	Price חובה. המחיר ליחידה של המוצר.
quantity	int64 חובה. השינוי היחסי של הכמות הזמינה. שלילי לפריטים שהוחזרו.
sale_time	Timestamp חובה. חותמת הזמן של המכירה.
uid	string פלט בלבד. המערכת יצרה מזהה ייחודי גלובלי עבור LfpSale.
feed_label	string זה שינוי אופציונלי. תווית הפיד של המוצר. אם לא קובעים במדיניות הזו שום הגדרה, ברירת המחדל היא regionCode.

LfpStore

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

שדות
name	string פלט בלבד. מזהה. שם המשאב LfpStore. פורמט: accounts/{account}/lfpStores/{target_merchant}~{store_code}
target_account	int64 חובה. מספר חשבון Merchant Center של המוכר שעבורו יש לשלוח את החנות.
store_code	string חובה. בלתי משתנה. מזהה חנות שהוא ייחודי למוכר היעד.
store_address	string חובה. הרחוב של החנות. דוגמה: 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA.
gcid_category[]	string זה שינוי אופציונלי. מזהה קטגוריה ב-'Google לעסק שלי'.
matching_state	StoreMatchingState זה שינוי אופציונלי. פלט בלבד. מצב ההתאמה לפרופיל העסק ב-Google. אם לא נמצאה התאמה, יש לעיין בכתובת matchingStateHint לקבלת פרטים נוספים.
store_name	string זה שינוי אופציונלי. שם המוֹכר או החנות.
phone_number	string זה שינוי אופציונלי. מספר הטלפון של החנות בפורמט E.164. לדוגמה: [phone]
website_uri	string זה שינוי אופציונלי. כתובת האתר של החנות או המוֹכר.
place_id	string זה שינוי אופציונלי. מזהה המקום ב-Google של מיקום החנות.
matching_state_hint	string זה שינוי אופציונלי. פלט בלבד. רמז לסיבה שבגללה ההתאמה נכשלה. הערך מוגדר רק כאשר matchingState=STORE_MATCHING_STATE_FAILED. הערכים האפשריים הם: 'linked-store-not-found': בפרופיל העסק ב-Google אין חנויות זמינות להתאמה. 'store-match-not-found': לא נמצאה התאמה בין LfpStore שצוין לבין אף אחת מהחנויות המקושרות בפרופיל העסק ב-Google. חשבון Merchant Center מקושר כמו שצריך ויש חנויות זמינות בפרופיל העסק ב-Google, אבל כתובת המיקום ב-LfpStore לא תואמת לכתובות של החנויות בפרופיל העסק ב-Google. צריך לעדכן את הכתובת בLfpStore או את כתובת החנות בפרופיל העסק ב-Google כך שיהיו זהות. 'store-match-unverified': לא נמצאה התאמה בין LfpStore שציינת לבין אף אחת מהחנויות המקושרות בפרופיל העסק ב-Google, כי החנות התואמת בפרופיל העסק ב-Google לא אומתה. צריך להשלים את תהליך האימות של פרופיל העסק ב-Google כדי שתהיה התאמה נכונה.

StoreMatchingState

מצב ההתאמה של LfpStore לפרופיל העסק ב-Google.

טיפוסים בני מנייה (enums)
STORE_MATCHING_STATE_UNSPECIFIED	לא צוין מצב ההתאמה לחנות.
STORE_MATCHING_STATE_MATCHED	הלקוח LfpStore הותאם בהצלחה לחנות בפרופיל העסק ב-Google.
STORE_MATCHING_STATE_FAILED	הכתובת LfpStore לא תואמת לחנות בפרופיל העסק ב-Google.

ListLfpStoresRequest

הודעת בקשה עבור השיטה ListLfpStores.

שדות
parent	string חובה. שותף ה-LFP. פורמט: accounts/{account}
target_account	int64 חובה. מספר חשבון Merchant Center של המוכר שעבורו רוצים להציג את החנויות.
page_size	int32 זה שינוי אופציונלי. המספר המקסימלי של LfpStore משאבים שיש להחזיר לחשבון הנתון. השירות מחזיר פחות מהערך הזה אם מספר החנויות בחשבון הנתון קטן מהערך pageSize. ערך ברירת המחדל הוא 250. הערך המקסימלי הוא 1,000. אם צוין ערך גבוה מהמקסימום, ברירת המחדל של pageSize היא הערך המקסימלי.
page_token	string זה שינוי אופציונלי. אסימון דף שהתקבל מקריאה קודמת של ListLfpStoresRequest. מספקים את אסימון הדף כדי לאחזר את הדף הבא. במהלך העימוד, כל הפרמטרים האחרים שצוינו ל-ListLfpStoresRequest חייבים להתאים לקריאה שסיפקה את אסימון הדף. האסימון הוחזר כ-nextPageToken בתגובה לבקשה הקודמת.

ListLfpStoresResponse

הודעת תגובה ל-method ListLfpStores.

שדות
lfp_stores[]	LfpStore החנויות מהמוכר שצוין.
next_page_token	string אסימון, שיכול להישלח בתור pageToken כדי לאחזר את הדף הבא. אם השדה הזה יושמט, לא יהיו דפים עוקבים.