Package google.shopping.merchant.lfp.v1beta

אינדקס

LfpInventoryService

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

InsertLfpInventory

rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory)

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

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.

LfpSaleService

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

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

הוספת LfpSale למוכר הנתון.

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.

LfpStoreService

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

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

מחיקת חנות של מוֹכר יעד.

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.
GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

אחזור מידע על חנות.

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.
InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

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

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

רשימה של החנויות של מוכר היעד, כפי שצוין במסנן שב-ListLfpStoresRequest.

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.

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

אופציונלי. שיטת האיסוף הנתמכת במבצע הזה. אלא אם הערך הוא 'not supported', צריך לשלוח את השדה הזה יחד עם pickupSla. כדי לבדוק אילו ערכים של מאפיינים מותרים, אפשר לעיין במפרט של נתוני מלאי המוצרים בחנויות המקומיות.
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. לדוגמה: +15556767888
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

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