Package google.shopping.merchant.inventories.v1beta

ดัชนี

LocalInventoryService

บริการจัดการสินค้าคงคลังในร้านสำหรับผลิตภัณฑ์

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

ลบ LocalInventory ที่ระบุออกจากผลิตภัณฑ์ที่ระบุในบัญชีผู้ขาย การลบ LocalInventory ออกจากผลิตภัณฑ์ที่เฉพาะเจาะจงอาจใช้เวลาถึง 1 ชั่วโมง เมื่อได้รับการตอบกลับการลบสำเร็จแล้ว ให้รอระยะเวลาดังกล่าวก่อนที่จะพยายามลบอีกครั้ง

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต 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 ในคำขอก่อนหน้า คุณจะใช้ pageToken นั้นเพื่อรับผลลัพธ์เพิ่มเติมได้

ทรัพยากร LocalInventory จะแสดงตามผลิตภัณฑ์สำหรับบัญชีหนึ่งๆ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

RegionalInventoryService

บริการสำหรับจัดการสินค้าคงคลังในภูมิภาคสำหรับผลิตภัณฑ์ นอกจากนี้ยังมีregionsแหล่งข้อมูลและ API แยกต่างหากสำหรับจัดการคำจำกัดความของภูมิภาค

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

ลบทรัพยากร RegionalInventory ที่ระบุออกจากผลิตภัณฑ์ที่ระบุในบัญชีผู้ขาย การลบ RegionalInventory ออกจากผลิตภัณฑ์ที่เฉพาะเจาะจงอาจใช้เวลาถึง 1 ชั่วโมง เมื่อได้รับการตอบกลับการลบสำเร็จแล้ว ให้รอระยะเวลาดังกล่าวก่อนที่จะพยายามลบอีกครั้ง

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต 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 ในคำขอก่อนหน้า คุณจะใช้ 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 ค่าสูงสุดคือ 25000 หากระบุค่าที่สูงกว่าค่าสูงสุด 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

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสร้านค้า (รหัสร้านค้าจาก Business Profile) ของร้านค้าจริงที่ขายผลิตภัณฑ์ ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดในการจัดทำข้อมูลสินค้าคงคลังของผลิตภัณฑ์ในร้าน
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

ความพร้อมจำหน่ายผลิตภัณฑ์ในภูมิภาคนี้ ดูค่าแอตทริบิวต์ที่ยอมรับได้ที่ข้อกำหนดในการจัดทำข้อมูลสินค้าคงคลังของผลิตภัณฑ์ระดับภูมิภาค