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

שירות לשותף של 'Google בעלי מקצוע' לשליחת חנויות מקומיות של מוכר.

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

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

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

InsertLfpInventoryRequest

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

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

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

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

ListLfpStoresRequest

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

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

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