ดัชนี
PromotionsService
(อินเทอร์เฟซ)Attributes
(ข้อความ)CouponValueType
(enum)GetPromotionRequest
(ข้อความ)InsertPromotionRequest
(ข้อความ)ListPromotionsRequest
(ข้อความ)ListPromotionsResponse
(ข้อความ)OfferType
(enum)ProductApplicability
(enum)Promotion
(ข้อความ)PromotionStatus
(ข้อความ)PromotionStatus.DestinationStatus
(ข้อความ)PromotionStatus.DestinationStatus.State
(enum)PromotionStatus.ItemLevelIssue
(ข้อความ)PromotionStatus.ItemLevelIssue.Severity
(enum)RedemptionChannel
(enum)StoreApplicability
(enum)
PromotionsService
บริการสำหรับจัดการโปรโมชันของผลิตภัณฑ์
GetPromotion |
---|
ดึงข้อมูลโปรโมชันจากบัญชี Merchant Center หลังจากแทรกหรืออัปเดตอินพุตโปรโมชันแล้ว ระบบอาจใช้เวลาสักครู่จึงจะเรียกข้อมูลโปรโมชันที่อัปเดตแล้วได้
|
InsertPromotion |
---|
แทรกโปรโมชันสำหรับบัญชี Merchant Center หากมีโปรโมชันอยู่แล้ว ระบบจะอัปเดตโปรโมชันแทน
|
ListPromotions |
---|
แสดงโปรโมชันในบัญชี Merchant Center การตอบกลับอาจมีรายการน้อยกว่าที่ หลังจากแทรกหรืออัปเดตโปรโมชันแล้ว ระบบอาจใช้เวลาหลายนาทีก่อนที่จะดึงข้อมูลโปรโมชันที่ประมวลผลแล้วซึ่งอัปเดตแล้วได้
|
Attributes
แอตทริบิวต์
ช่อง | |
---|---|
product_ |
ต้องระบุ การใช้โปรโมชันกับผลิตภัณฑ์ทั้งหมดหรือเฉพาะผลิตภัณฑ์ที่เฉพาะเจาะจง |
offer_ |
ต้องระบุ ประเภทโปรโมชัน ใช้แอตทริบิวต์นี้เพื่อระบุว่าลูกค้าต้องใช้รหัสคูปองเพื่อแลกสิทธิ์โปรโมชันหรือไม่ |
generic_ |
ไม่บังคับ รหัสแลกรับข้อเสนอทั่วไปสำหรับโปรโมชัน ใช้กับช่อง |
long_ |
ต้องระบุ ชื่อแบบยาวของโปรโมชัน |
coupon_ |
ต้องระบุ แอตทริบิวต์ประเภทมูลค่าของคูปองเพื่อระบุประเภทโปรโมชันที่คุณใช้อยู่ ต้องระบุแอตทริบิวต์บางรายการ ทั้งนี้ขึ้นอยู่กับประเภทมูลค่าของคูปองที่คุณเลือก |
promotion_ |
ต้องระบุ รายการปลายทางที่มีสิทธิ์ใช้โปรโมชัน หากไม่ได้ระบุปลายทางด้วยการใส่ค่าที่รองรับในแหล่งข้อมูล โปรโมชันจะแสดงในโฆษณา Shopping และข้อมูลที่แสดงฟรีโดยค่าเริ่มต้น ก่อนหน้านี้คุณอาจส่งค่า Shopping Actions, Surfaces across Google และ Local surfaces across Google เป็นปลายทางสำหรับผลิตภัณฑ์ หากต้องการแสดงค่าเหล่านี้ ให้ใช้ |
item_ |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสสินค้าสำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ |
brand_ |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามแบรนด์สำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ |
item_ |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสกลุ่มสินค้าสำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ [product_applicability] ของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชันเป็น specific_products |
product_ |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามประเภทผลิตภัณฑ์สำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ |
item_ |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นรหัสสินค้าสำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ |
brand_ |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นแบรนด์สำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ |
item_ |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสกลุ่มสินค้า แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ |
product_ |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นประเภทผลิตภัณฑ์สำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ |
minimum_ |
ไม่บังคับ ยอดสั่งซื้อขั้นต่ำสำหรับโปรโมชัน |
minimum_ |
ไม่บังคับ จำนวนการซื้อขั้นต่ำสำหรับโปรโมชัน |
limit_ |
ไม่บังคับ จำนวนการซื้อสูงสุดสำหรับโปรโมชัน |
limit_ |
ไม่บังคับ ราคาผลิตภัณฑ์สูงสุดสำหรับโปรโมชัน |
percent_ |
ไม่บังคับ เปอร์เซ็นต์ส่วนลดที่มีให้ในโปรโมชัน |
money_ |
ไม่บังคับ จำนวนเงินส่วนลดที่เสนอในโปรโมชัน |
get_ |
ไม่บังคับ จํานวนสินค้าที่ลดราคาในโปรโมชัน ระบบจะตั้งค่าแอตทริบิวต์เมื่อ |
free_ |
ไม่บังคับ มูลค่าของขวัญฟรีสำหรับโปรโมชัน |
free_ |
ไม่บังคับ รายละเอียดของขวัญฟรีสำหรับโปรโมชัน |
free_ |
ไม่บังคับ รหัสสินค้าของขวัญฟรีสำหรับโปรโมชัน |
promotion_ |
ต้องระบุ |
promotion_ |
ไม่บังคับ |
store_ |
ไม่บังคับ ระบุว่าโปรโมชันมีผลกับร้านค้าทั้งหมดหรือเฉพาะบางร้านค้า โปรโมชันโฆษณาสินค้าคงคลังในร้านจะแสดงข้อผิดพลาดหากไม่มีการนำไปใช้กับร้านค้า ระบบจะแสดงข้อผิดพลาด |
store_ |
ไม่บังคับ รหัสร้านค้าที่จะรวมในโปรโมชัน แอตทริบิวต์ตัวกรองร้านค้าจะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ รหัสร้านค้า (รหัสร้านค้าจาก Business Profile) ของร้านค้าจริงที่ขายผลิตภัณฑ์ ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดในการจัดทำข้อมูลสินค้าคงคลังของผลิตภัณฑ์ในร้าน |
store_ |
ไม่บังคับ รหัสร้านค้าที่จะยกเว้นสำหรับโปรโมชัน แอตทริบิวต์ตัวกรองร้านค้าจะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ |
promotion_ |
ไม่บังคับ URL ไปยังหน้าในเว็บไซต์ของผู้ขายที่แสดงโปรโมชัน โปรโมชันโฆษณาสินค้าคงคลังในร้านจะแสดงข้อผิดพลาดหากไม่มี |
CouponValueType
ประเภทมูลค่าของคูปองของโปรโมชัน
Enum | |
---|---|
COUPON_VALUE_TYPE_UNSPECIFIED |
ระบุว่าไม่ได้ระบุประเภทมูลค่าของคูปอง |
MONEY_OFF |
ประเภทมูลค่าของคูปองเป็นส่วนลด |
PERCENT_OFF |
ประเภทมูลค่าของคูปองเป็นเปอร์เซ็นต์ส่วนลด |
BUY_M_GET_N_MONEY_OFF |
ประเภทมูลค่าของคูปอง "ซื้อครบ M แล้วรับส่วนลด N" ต้องแสดง minimum_purchase_quantity และ get_this_quantity_discounted และต้องมี money_off_amount ด้วย |
BUY_M_GET_N_PERCENT_OFF |
ซื้อ M รายการ รับส่วนลด N เปอร์เซ็นต์จากประเภทมูลค่าของคูปอง ต้องแสดง minimum_purchase_quantity และ get_this_quantity_discounted และต้องมี percent_off_percentage ด้วย |
BUY_M_GET_MONEY_OFF |
ซื้อ M รายการและรับส่วนลดเป็นเงิน โดยต้องมี minimum_purchase_quantity และ money_off_amount |
BUY_M_GET_PERCENT_OFF |
ซื้อ M รายการและรับส่วนลดเป็นเงิน โดยต้องมี minimum_purchase_quantity และ percent_off_percentage |
FREE_GIFT |
ของขวัญฟรีที่มีคำอธิบายเท่านั้น |
FREE_GIFT_WITH_VALUE |
ของขวัญฟรีที่มีมูลค่าทางการเงิน |
FREE_GIFT_WITH_ITEM_ID |
ของขวัญฟรีที่มีรหัสสินค้า |
FREE_SHIPPING_STANDARD |
ประเภทมูลค่าของคูปองจัดส่งฟรีแบบมาตรฐาน ใช้ได้กับโปรโมชันออนไลน์เท่านั้น |
FREE_SHIPPING_OVERNIGHT |
ประเภทมูลค่าของคูปองจัดส่งฟรีข้ามคืน ใช้ได้กับโปรโมชันออนไลน์เท่านั้น |
FREE_SHIPPING_TWO_DAY |
ประเภทมูลค่าของคูปองจัดส่งฟรีใน 2 วัน ใช้ได้กับโปรโมชันออนไลน์เท่านั้น |
GetPromotionRequest
คำขอข้อความสำหรับเมธอด GetPromotion
ช่อง | |
---|---|
name |
ต้องระบุ ชื่อของโปรโมชันที่จะดึงข้อมูล รูปแบบ: |
InsertPromotionRequest
คำขอข้อความสำหรับเมธอด InsertPromotion
ช่อง | |
---|---|
parent |
ต้องระบุ บัญชีที่จะแทรกโปรโมชัน รูปแบบ: accounts/{account} |
promotion |
ต้องระบุ โปรโมชันที่จะแทรก |
data_ |
ต้องระบุ แหล่งข้อมูลของรูปแบบโปรโมชัน: |
ListPromotionsRequest
คำขอข้อความสำหรับเมธอด ListPromotions
ช่อง | |
---|---|
parent |
ต้องระบุ บัญชีที่จะแสดงรายการโปรโมชันที่ประมวลผลแล้ว รูปแบบ: |
page_ |
เอาต์พุตเท่านั้น จำนวนโปรโมชันสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ ค่าสูงสุดคือ 250 ค่าที่มากกว่า 250 จะเปลี่ยนเป็น 250 หากไม่ได้ระบุ ระบบจะแสดงผลโปรโมชันจำนวนสูงสุด |
page_ |
เอาต์พุตเท่านั้น โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ เมื่อแบ่งหน้าเว็บ พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ |
ListPromotionsResponse
ข้อความตอบกลับสําหรับเมธอด ListPromotions
ช่อง | |
---|---|
promotions[] |
โปรโมชันที่ประมวลผลแล้วจากบัญชีที่ระบุ |
next_ |
โทเค็น ซึ่งสามารถส่งเป็น |
OfferType
ประเภทข้อเสนอของโปรโมชัน
Enum | |
---|---|
OFFER_TYPE_UNSPECIFIED |
ประเภทข้อเสนอที่ไม่รู้จัก |
NO_CODE |
ประเภทข้อเสนอที่ไม่มีรหัส |
GENERIC_CODE |
ประเภทข้อเสนอที่มีรหัส ต้องระบุรหัสแลกรับข้อเสนอทั่วไปสำหรับโปรโมชันเมื่อ offerType = GENERIC_CODE |
ProductApplicability
ผลิตภัณฑ์หรือรายการผลิตภัณฑ์ที่โปรโมชันมีผล
Enum | |
---|---|
PRODUCT_APPLICABILITY_UNSPECIFIED |
ไม่ทราบผลิตภัณฑ์ที่โปรโมชันมีผล |
ALL_PRODUCTS |
ใช้กับผลิตภัณฑ์ทั้งหมดได้ |
SPECIFIC_PRODUCTS |
ใช้กับผลิตภัณฑ์หรือรายการผลิตภัณฑ์รายการเดียวเท่านั้น |
โปรโมชัน
แสดงถึงโปรโมชัน ดูรายละเอียดเพิ่มเติมได้ที่บทความต่อไปนี้
แอตทริบิวต์อินพุตโปรโมชันที่จําเป็นในการผ่านการตรวจสอบความถูกต้องของข้อมูลมีคำจำกัดความหลักๆ ดังนี้
หลังจากแทรกและอัปเดตข้อมูลโปรโมชันแล้ว ระบบอาจใช้เวลา 2-3 นาทีจึงจะเรียกข้อมูลโปรโมชันสุดท้ายได้
ช่อง | |
---|---|
name |
ตัวระบุ ชื่อของโปรโมชัน รูปแบบ: |
promotion_ |
ต้องระบุ รหัสโปรโมชันที่ผู้ใช้ระบุเพื่อระบุโปรโมชันนั้นๆ โดยไม่ซ้ำกัน ปฏิบัติตามข้อกำหนดขั้นต่ำเพื่อป้องกันไม่ให้มีการไม่อนุมัติโปรโมชัน |
content_ |
ต้องระบุ รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรของโปรโมชัน โปรโมชันมีให้บริการในบางภาษาเท่านั้น |
target_ |
ต้องระบุ ประเทศเป้าหมายที่ใช้เป็นส่วนหนึ่งของตัวระบุที่ไม่ซ้ำ แสดงเป็นรหัสเขตแดน CLDR โปรโมชันใช้ได้เฉพาะในบางประเทศ ข้อมูลที่แสดงฟรีและโฆษณา Shopping โฆษณาสินค้าคงคลังในร้าน |
redemption_ |
ต้องระบุ ช่องทางการแลกรับสิทธิ์สำหรับโปรโมชัน ต้องมีแชแนลอย่างน้อย 1 รายการ |
data_ |
เอาต์พุตเท่านั้น แหล่งข้อมูลหลักของโปรโมชัน |
attributes |
ไม่บังคับ รายการแอตทริบิวต์โปรโมชัน |
custom_ |
ไม่บังคับ รายการแอตทริบิวต์ที่กำหนดเอง (ผู้ขายระบุ) นอกจากนี้ยังใช้ส่งแอตทริบิวต์ของข้อกำหนดในการจัดทำข้อมูลในรูปแบบทั่วไป (เช่น |
promotion_ |
เอาต์พุตเท่านั้น สถานะของการโปรโมต ปัญหาการตรวจสอบข้อมูล ซึ่งก็คือข้อมูลเกี่ยวกับการโปรโมตที่ประมวลผลแบบไม่พร้อมกัน |
version_ |
ไม่บังคับ แสดงเวอร์ชันที่มีอยู่ (ความใหม่) ของโปรโมชัน ซึ่งสามารถใช้เพื่อรักษาลําดับที่ถูกต้องเมื่อมีการอัปเดตหลายรายการพร้อมกัน หากตั้งค่าไว้ ระบบจะป้องกันไม่ให้แทรกเมื่อหมายเลขเวอร์ชันต่ำกว่าหมายเลขเวอร์ชันปัจจุบันของโปรโมชันที่มีอยู่ คุณสามารถแทรก หากมีการป้องกันการดําเนินการ ระบบจะแสดงข้อยกเว้นที่ยกเลิก |
PromotionStatus
สถานะโปรโมชัน
ช่อง | |
---|---|
destination_ |
เอาต์พุตเท่านั้น ปลายทางที่ต้องการสำหรับโปรโมชัน |
item_ |
เอาต์พุตเท่านั้น รายการปัญหาที่เกี่ยวข้องกับโปรโมชัน |
creation_ |
เอาต์พุตเท่านั้น วันที่สร้างโปรโมชันในรูปแบบ ISO 8601: วันที่ เวลา และออฟเซ็ต เช่น |
last_ |
เอาต์พุตเท่านั้น วันที่อัปเดตสถานะโปรโมชันครั้งล่าสุดในรูปแบบ ISO 8601: วันที่ เวลา และออฟเซ็ต เช่น |
DestinationStatus
สถานะของปลายทางที่ระบุ
ช่อง | |
---|---|
reporting_ |
เอาต์พุตเท่านั้น ชื่อของปลายทางของโปรโมชัน |
status |
เอาต์พุตเท่านั้น สถานะสำหรับปลายทางที่ระบุ |
รัฐ
สถานะปัจจุบันของโปรโมชัน
Enum | |
---|---|
STATE_UNSPECIFIED |
สถานะโปรโมชันที่ไม่รู้จัก |
IN_REVIEW |
โปรโมชันอยู่ระหว่างตรวจสอบ |
REJECTED |
โปรโมชันไม่ได้รับอนุมัติ |
LIVE |
โปรโมชันได้รับอนุมัติและใช้งานได้ |
STOPPED |
ผู้ขายหยุดโปรโมชันแล้ว |
EXPIRED |
โปรโมชันไม่ทำงานแล้ว |
PENDING |
โปรโมชันไม่ได้หยุดลงและการตรวจสอบทั้งหมดได้รับอนุมัติแล้ว แต่วันที่ที่ใช้งานอยู่คือวันที่ในอนาคต |
ItemLevelIssue
ปัญหาที่เกี่ยวข้องกับโปรโมชัน
ช่อง | |
---|---|
code |
เอาต์พุตเท่านั้น รหัสข้อผิดพลาดของปัญหา |
severity |
เอาต์พุตเท่านั้น ปัญหานี้ส่งผลต่อการแสดงโปรโมชันอย่างไร |
resolution |
เอาต์พุตเท่านั้น ผู้ขายสามารถแก้ไขปัญหาได้หรือไม่ |
attribute |
เอาต์พุตเท่านั้น ชื่อแอตทริบิวต์ หากปัญหาเกิดจากแอตทริบิวต์รายการเดียว |
reporting_ |
เอาต์พุตเท่านั้น ปลายทางที่มีปัญหา |
description |
เอาต์พุตเท่านั้น คำอธิบายปัญหาสั้นๆ เป็นภาษาอังกฤษ |
detail |
เอาต์พุตเท่านั้น คำอธิบายปัญหาโดยละเอียดเป็นภาษาอังกฤษ |
documentation |
เอาต์พุตเท่านั้น URL ของหน้าเว็บเพื่อช่วยแก้ปัญหานี้ |
applicable_ |
เอาต์พุตเท่านั้น รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่มีปัญหากับข้อเสนอ |
ความรุนแรง
ความรุนแรงของปัญหา
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
ไม่ได้ระบุ |
NOT_IMPACTED |
ปัญหานี้แสดงคำเตือนและไม่มีผลกระทบโดยตรงต่อโปรโมชัน |
DEMOTED |
โปรโมชันถูกลดระดับและมีแนวโน้มที่จะมีประสิทธิภาพจํากัดในผลการค้นหา |
DISAPPROVED |
ปัญหาที่ส่งผลให้โปรโมชันไม่ได้รับอนุมัติ |
RedemptionChannel
ช่องทางของโปรโมชัน
Enum | |
---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
บ่งบอกว่าไม่ได้ระบุแชแนล |
IN_STORE |
บ่งบอกว่าช่องมีให้บริการใน Store ซึ่งช่องนี้เหมือนกับช่อง local ที่ใช้ในการเผยแพร่ products |
ONLINE |
บ่งบอกว่าช่องออนไลน์อยู่ |
StoreApplicability
รหัสร้านค้าหรือรายการรหัสร้านค้าที่โปรโมชันมีผล สำหรับโปรโมชันโฆษณาสินค้าคงคลังในร้านเท่านั้น
Enum | |
---|---|
STORE_APPLICABILITY_UNSPECIFIED |
ไม่ทราบรหัสร้านค้าที่ใช้โปรโมชัน |
ALL_STORES |
ใช้โปรโมชันกับทุกร้านค้า |
SPECIFIC_STORES |
โปรโมชันใช้ได้กับร้านค้าที่ระบุเท่านั้น |