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.
InsertLocalInventory

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

מוסיף משאב LocalInventory למוצר בחשבון המוכר שלך.

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

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

היקפי הרשאות

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

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

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.
ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

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

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

היקפי הרשאות

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

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

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

RegionalInventoryService

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

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

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

היקפי הרשאות

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

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

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.
InsertRegionalInventory

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

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

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

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

היקפי הרשאות

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

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

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.
ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

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

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

היקפי הרשאות

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

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

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

DeleteLocalInventoryRequest

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

שדות
name

string

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

DeleteRegionalInventoryRequest

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

שדות
name

string

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

InsertLocalInventoryRequest

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

שדות
parent

string

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

LocalInventory

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

InsertRegionalInventoryRequest

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

שדות
parent

string

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

RegionalInventory

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

ListLocalInventoriesRequest

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

שדות
parent

string

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

int32

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

string

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

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

ListLocalInventoriesResponse

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

שדות
local_inventories[]

LocalInventory

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

string

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

ListRegionalInventoriesRequest

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

שדות
parent

string

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

int32

המספר המקסימלי של RegionalInventory משאבים שיש להחזיר למוצר הנתון. השירות יחזיר פחות מהערך הזה אם מספר המלאים של המוצר הנתון נמוך מהערך של pageSize. ערך ברירת המחדל הוא 25000. הערך המקסימלי הוא 100,000; אם צוין ערך גבוה מהמקסימום, ברירת המחדל של 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

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

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