Package google.shopping.merchant.inventories.v1beta

אינדקס

LocalInventoryService

שירות לניהול מלאי מוצרים בחנויות מקומיות

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

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

היקפי הרשאה

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

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

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

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

הוספת משאב LocalInventory למוצר בחשבון המוכר.

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

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

היקפי הרשאה

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

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

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

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

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

המשאבים של LocalInventory מפורטים לכל מוצר בחשבון נתון.

היקפי הרשאה

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

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

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

RegionalInventoryService

שירות לניהול מלאי מוצרים אזורי. יש גם משאב API נפרד של regions לניהול הגדרות האזורים.

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

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

היקפי הרשאה

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

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

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

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

הוספת RegionalInventory למוצר נתון בחשבון המוכר.

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

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

היקפי הרשאה

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

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

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

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

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

המשאבים של RegionalInventory מפורטים לכל מוצר בחשבון נתון.

היקפי הרשאה

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

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

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

DeleteLocalInventoryRequest

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

שדות
name

string

חובה. השם של מלאי המוצרים בחנות המקומית של המוצר שרוצים למחוק. פורמט: accounts/{account}/products/{product}/localInventories/{store_code}

DeleteRegionalInventoryRequest

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

שדות
name

string

חובה. השם של משאב RegionalInventory שרוצים למחוק. פורמט: accounts/{account}/products/{product}/regionalInventories/{region}

InsertLocalInventoryRequest

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

שדות
parent

string

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

LocalInventory

חובה. פרטי המלאי המקומי של המוצר. אם למוצר כבר יש משאב LocalInventory לאותו storeCode, מתבצעת החלפה מלאה של משאב ה-LocalInventory.

InsertRegionalInventoryRequest

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

שדות
parent

string

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

RegionalInventory

חובה. פרטי מלאי אזוריים שרוצים להוסיף למוצר. אם למוצר כבר יש משאב RegionalInventory לאותו region, מתבצעת החלפה מלאה של משאב ה-RegionalInventory.

ListLocalInventoriesRequest

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

שדות
parent

string

חובה. ה-name של מוצר ההורה שרוצים להציג עבורו מלאי בחנויות מקומיות. פורמט: accounts/{account}/products/{product}
page_size

int32

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

string

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

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

ListLocalInventoriesResponse

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

שדות
local_inventories[]

LocalInventory

המשאבים מסוג LocalInventory של המוצר הנתון מהחשבון שצוין.
next_page_token

string

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

ListRegionalInventoriesRequest

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

שדות
parent

string

חובה. ה-name של המוצר ההורה שעבורו רוצים לקבל רשימה של משאבי RegionalInventory. פורמט: accounts/{account}/products/{product}
page_size

int32

המספר המקסימלי של משאבי RegionalInventory שיוחזר עבור המוצר הנתון. אם מספר המלאי של המוצר הנתון נמוך מ-pageSize, השירות מחזיר פחות מהערך הזה. ערך ברירת המחדל הוא 25,000. הערך המקסימלי הוא 100000. אם יצוין ערך גבוה מהערך המקסימלי, הערך של pageSize יהיה ברירת המחדל של הערך המקסימלי.
page_token

string

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

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

ListRegionalInventoriesResponse

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

שדות
regional_inventories[]

RegionalInventory

המשאבים מסוג RegionalInventory של המוצר הנתון מהחשבון שצוין.
next_page_token

string

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

LocalInventory

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

שדות
name

string

פלט בלבד. השם של משאב LocalInventory. פורמט: accounts/{account}/products/{product}/localInventories/{store_code}
account

int64

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

string

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

Price

מחיר המוצר בחנות הזו.
sale_price

Price

מחיר המבצע של המוצר בחנות הזו. חובה אם salePriceEffectiveDate מוגדר.
sale_price_effective_date

Interval

TimePeriod של המכירה בחנות הזו.
custom_attributes[]

CustomAttribute

רשימה של מאפיינים מותאמים אישית (שסופקו על ידי המוכר). אפשר גם להשתמש ב-CustomAttribute כדי לשלוח כל מאפיין של מפרט הנתונים בצורתו הגנרית.
availability

string

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

int64

כמות המוצר שזמינה בחנות. הערך חייב להיות גדול מ-0 או שווה לו.
pickup_method

string

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

string

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

string

מיקום המוצר בתוך החנות. האורך המקסימלי הוא 20 בייטים.

RegionalInventory

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

שדות
name

string

פלט בלבד. השם של משאב RegionalInventory. פורמט: {regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}
account

int64

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

string

חובה. לא ניתן לשינוי. המזהה של האזור של משאב ה-RegionalInventory הזה. פרטים נוספים זמינים במאמר זמינות ותמחור לפי אזור.
price

Price

מחיר המוצר באזור הזה.
sale_price

Price

מחיר המכירה של המוצר באזור הזה. חובה אם salePriceEffectiveDate מוגדר.
sale_price_effective_date

Interval

TimePeriod של מחיר המבצע באזור הזה.
custom_attributes[]

CustomAttribute

רשימה של מאפיינים מותאמים אישית (שסופקו על ידי המוכר). אפשר גם להשתמש ב-CustomAttribute כדי לשלוח כל מאפיין של מפרט הנתונים בצורתו הגנרית.
availability

string

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