ดัชนี
- 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 | โปรโมชันใช้ได้กับร้านค้าที่ระบุเท่านั้น |