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

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

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

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

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

ต้องใช้ขอบเขต 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

ข้อความคำขอสำหรับเมธอด 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 ค่าเริ่มต้นคือ 25000 ค่าสูงสุดคือ 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 ค่าเริ่มต้นคือ 25000 ค่าสูงสุดคือ 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

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