ดัชนี
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_applicability |
ต้องระบุ ความเกี่ยวข้องของโปรโมชันกับผลิตภัณฑ์ทั้งหมดหรือเฉพาะผลิตภัณฑ์ที่เฉพาะเจาะจง |
offer_type |
ต้องระบุ ประเภทของโปรโมชัน ใช้แอตทริบิวต์นี้เพื่อระบุว่าลูกค้าต้องใช้รหัสคูปองเพื่อแลกสิทธิ์โปรโมชันหรือไม่ |
generic_redemption_code |
ไม่บังคับ รหัสแลกรับข้อเสนอทั่วไปสำหรับโปรโมชัน เพื่อใช้กับช่อง |
long_title |
ต้องระบุ ชื่อเต็มสำหรับโปรโมชัน |
coupon_value_type |
ต้องระบุ แอตทริบิวต์ coupon value type เพื่อระบุประเภทโปรโมชันที่ใช้งานอยู่ ต้องระบุแอตทริบิวต์บางรายการ ทั้งนี้ขึ้นอยู่กับประเภทของมูลค่าคูปองที่เลือก |
promotion_destinations[] |
ต้องระบุ รายการปลายทางที่ใช้โปรโมชัน หากไม่ระบุปลายทางด้วยการใส่ค่าที่รองรับในแหล่งข้อมูล โปรโมชันจะแสดงในโฆษณา Shopping และข้อมูลที่แสดงฟรีโดยค่าเริ่มต้น ก่อนหน้านี้คุณอาจส่งค่า Shopping Actions, แพลตฟอร์มของ Google, แพลตฟอร์มในพื้นที่ของ Google เป็นปลายทางสำหรับผลิตภัณฑ์ หากต้องการแทนค่าเหล่านี้ ให้ใช้ |
item_id_inclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสสินค้าสำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
brand_inclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามแบรนด์สำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
item_group_id_inclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสกลุ่มสินค้าสำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์โปรโมชัน [product_applicability] เป็น specific_products |
product_type_inclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามประเภทผลิตภัณฑ์สำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
item_id_exclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นรหัสสินค้าสำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
brand_exclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นแบรนด์สำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
item_group_id_exclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสกลุ่มสินค้า ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
product_type_exclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นประเภทผลิตภัณฑ์สำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
minimum_purchase_amount |
ไม่บังคับ ยอดสั่งซื้อขั้นต่ำสำหรับโปรโมชัน |
minimum_purchase_quantity |
ไม่บังคับ จำนวนการซื้อขั้นต่ำสำหรับโปรโมชัน |
limit_quantity |
ไม่บังคับ จำนวนการซื้อสูงสุดสำหรับโปรโมชัน |
limit_value |
ไม่บังคับ ราคาผลิตภัณฑ์สูงสุดสำหรับโปรโมชัน |
percent_off |
ไม่บังคับ ส่วนลดเป็นเปอร์เซ็นต์ที่เสนอในโปรโมชัน |
money_off_amount |
ไม่บังคับ จำนวนเงินส่วนลดที่เสนอในโปรโมชัน |
get_this_quantity_discounted |
ไม่บังคับ จํานวนสินค้าที่ให้ส่วนลดในโปรโมชัน ระบบจะตั้งค่าแอตทริบิวต์เมื่อ |
free_gift_value |
ไม่บังคับ มูลค่าของขวัญฟรีสำหรับโปรโมชัน |
free_gift_description |
ไม่บังคับ รายละเอียดของขวัญฟรีสำหรับโปรโมชัน |
free_gift_item_id |
ไม่บังคับ รหัสสินค้าของขวัญฟรีสำหรับโปรโมชัน |
promotion_effective_time_period |
ต้องระบุ |
promotion_display_time_period |
ไม่บังคับ |
store_applicability |
ไม่บังคับ ใช้โปรโมชันกับร้านค้าทั้งหมดหรือเฉพาะร้านค้าที่ระบุ การโปรโมตโฆษณาสินค้าคงคลังในร้านจะเกิดข้อผิดพลาดหากไม่มีความเกี่ยวข้องกับร้านค้า ระบบจะแสดงข้อผิดพลาด |
store_codes_inclusion[] |
ไม่บังคับ รหัสร้านค้าที่จะรวมสำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองร้านค้าเมื่อตั้งค่าแอตทริบิวต์ รหัสร้านค้า (รหัสร้านค้าจาก Business Profile) ของกิจการที่มีหน้าร้านจริงที่ขายผลิตภัณฑ์ ดูข้อมูลเพิ่มเติมได้ในข้อกำหนดในการจัดทำข้อมูลสินค้าคงคลังของผลิตภัณฑ์ในร้าน |
store_codes_exclusion[] |
ไม่บังคับ รหัสร้านค้าที่จะยกเว้นสำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองร้านค้าเมื่อตั้งค่าแอตทริบิวต์ |
promotion_url |
ไม่บังคับ 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_source |
ต้องระบุ แหล่งข้อมูลของรูปแบบโปรโมชัน: |
ListPromotionsRequest
ข้อความคําขอสําหรับเมธอด ListPromotions
ช่อง | |
---|---|
parent |
ต้องระบุ บัญชีที่จะแสดงโปรโมชันที่ประมวลผลแล้ว รูปแบบ: |
page_size |
เอาต์พุตเท่านั้น จำนวนโปรโมชันสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ ค่าสูงสุดคือ 1,000 ค่าที่มากกว่า 1000 จะถูกเปลี่ยนเป็น 1000 หากไม่ระบุ ระบบจะแสดงผลโปรโมชันสูงสุด |
page_token |
เอาต์พุตเท่านั้น โทเค็นของหน้าเว็บที่ได้รับจากการโทร เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ให้กับ |
ListPromotionsResponse
ข้อความตอบกลับสำหรับเมธอด ListPromotions
ช่อง | |
---|---|
promotions[] |
โปรโมชันที่ประมวลผลจากบัญชีที่ระบุ |
next_page_token |
โทเค็นซึ่งสามารถส่งเป็น |
OfferType
ประเภทข้อเสนอของโปรโมชัน
Enum | |
---|---|
OFFER_TYPE_UNSPECIFIED |
ประเภทข้อเสนอที่ไม่รู้จัก |
NO_CODE |
ประเภทข้อเสนอที่ไม่มีรหัส |
GENERIC_CODE |
ประเภทข้อเสนอโดยใช้รหัส คุณต้องระบุรหัสแลกรับข้อเสนอทั่วไปสำหรับโปรโมชันเมื่อ offerType = GENERIC_CODE |
ProductApplicability
ผลิตภัณฑ์หรือรายการผลิตภัณฑ์ที่ใช้โปรโมชันนั้น
Enum | |
---|---|
PRODUCT_APPLICABILITY_UNSPECIFIED |
ไม่ทราบผลิตภัณฑ์ที่จะใช้โปรโมชันนี้ |
ALL_PRODUCTS |
ใช้ได้กับผลิตภัณฑ์ทั้งหมด |
SPECIFIC_PRODUCTS |
ใช้ได้กับผลิตภัณฑ์หรือรายการผลิตภัณฑ์รายการเดียว |
โปรโมชัน
แสดงโปรโมชัน โปรดดูรายละเอียดเพิ่มเติมในบทความต่อไปนี้
แอตทริบิวต์อินพุตโปรโมชันที่ต้องระบุเพื่อให้ผ่านการตรวจสอบความถูกต้องของข้อมูลมีดังนี้
หลังจากแทรกแล้ว การอัปเดตข้อมูลโปรโมชัน อาจต้องรอหลายนาทีกว่าจะดึงข้อมูลโปรโมชันสุดท้ายได้
ช่อง | |
---|---|
name |
ตัวระบุ ชื่อของโปรโมชัน รูปแบบ: |
promotion_id |
ต้องระบุ ผู้ใช้ระบุรหัสโปรโมชันเพื่อระบุโปรโมชันโดยไม่ซ้ำกัน ปฏิบัติตามข้อกำหนดขั้นต่ำเพื่อป้องกันการไม่อนุมัติโปรโมชัน |
content_language |
ต้องระบุ รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรสำหรับโปรโมชัน โปรโมชันใช้ได้กับภาษาที่เลือกเท่านั้น |
target_country |
ต้องระบุ ประเทศเป้าหมายที่ใช้เป็นส่วนหนึ่งของตัวระบุที่ไม่ซ้ำกัน แสดงเป็นรหัสเขตแดน CLDR โปรโมชันมีให้บริการเฉพาะในบางประเทศ รวมถึงโฆษณาสินค้าคงคลังในร้านและข้อมูลที่แสดงฟรีและโฆษณา Shopping เท่านั้น |
redemption_channel[] |
ต้องระบุ ช่องทางการแลกสิทธิ์สำหรับโปรโมชัน ต้องมีแชแนลอย่างน้อย 1 รายการ |
data_source |
เอาต์พุตเท่านั้น แหล่งข้อมูลหลักของโปรโมชัน |
attributes |
ไม่บังคับ รายการแอตทริบิวต์โปรโมชัน |
custom_attributes[] |
ไม่บังคับ รายการแอตทริบิวต์ที่กำหนดเอง (ระบุโดยผู้ขาย) นอกจากนี้ ยังใช้สำหรับการส่งแอตทริบิวต์ของข้อกำหนดในการจัดทำข้อมูลในรูปแบบทั่วไป (เช่น |
promotion_status |
เอาต์พุตเท่านั้น สถานะของโปรโมชัน ปัญหาในการตรวจสอบข้อมูล ซึ่งก็คือข้อมูลเกี่ยวกับโปรโมชันที่คำนวณแบบไม่พร้อมกัน |
version_number |
ไม่บังคับ แสดงโปรโมชันเวอร์ชันที่มีอยู่ (ความใหม่) ซึ่งใช้เพื่อรักษาลำดับที่เหมาะสมเมื่ออัปเดตหลายรายการพร้อมกัน หากตั้งค่าไว้ ระบบจะป้องกันการแทรกเมื่อหมายเลขเวอร์ชันต่ำกว่าหมายเลขเวอร์ชันปัจจุบันของโปรโมชันที่มีอยู่ การแทรกอีกครั้ง (เช่น รีเฟรชโปรโมชันหลังผ่านไป 30 วัน) จะดำเนินการด้วย หากมีการป้องกันการดำเนินการ ข้อยกเว้นที่ล้มเลิกจะถูกยกเลิก |
PromotionStatus
สถานะของโปรโมชัน
ช่อง | |
---|---|
destination_statuses[] |
เอาต์พุตเท่านั้น ปลายทางที่ต้องการสำหรับโปรโมชัน |
item_level_issues[] |
เอาต์พุตเท่านั้น รายการปัญหาที่เกี่ยวข้องกับโปรโมชัน |
creation_date |
เอาต์พุตเท่านั้น วันที่สร้างโปรโมชันในรูปแบบ ISO 8601 ได้แก่ วันที่ เวลา และออฟเซ็ต เช่น |
last_update_date |
เอาต์พุตเท่านั้น วันที่ที่อัปเดตสถานะโปรโมชันครั้งล่าสุดในรูปแบบ ISO 8601 ซึ่งได้แก่ วันที่ เวลา และออฟเซ็ต เช่น |
DestinationStatus
สถานะของปลายทางที่ระบุ
ช่อง | |
---|---|
reporting_context |
เอาต์พุตเท่านั้น ชื่อของปลายทางโปรโมชัน |
status |
เอาต์พุตเท่านั้น สถานะของปลายทางที่ระบุ |
รัฐ
สถานะปัจจุบันของโปรโมชัน
Enum | |
---|---|
STATE_UNSPECIFIED |
สถานะโปรโมชันที่ไม่รู้จัก |
IN_REVIEW |
โปรโมชันอยู่ระหว่างตรวจสอบ |
REJECTED |
โปรโมชันไม่ได้รับอนุมัติ |
LIVE |
โปรโมชันได้รับอนุมัติแล้วและใช้งานได้ |
STOPPED |
ผู้ขายหยุดโปรโมชันแล้ว |
EXPIRED |
โปรโมชันนี้ใช้งานไม่ได้แล้ว |
PENDING |
เราไม่ได้หยุดใช้โปรโมชันและการตรวจสอบทั้งหมดได้รับอนุมัติแล้ว แต่วันที่เปิดใช้งานถือเป็นวันที่ในอนาคต |
ItemLevelIssue
ปัญหาที่เกี่ยวข้องกับโปรโมชัน
ช่อง | |
---|---|
code |
เอาต์พุตเท่านั้น รหัสข้อผิดพลาดของปัญหา |
severity |
เอาต์พุตเท่านั้น ปัญหานี้ส่งผลต่อการแสดงโปรโมชันอย่างไร |
resolution |
เอาต์พุตเท่านั้น ผู้ขายแก้ไขปัญหาได้หรือไม่ |
attribute |
เอาต์พุตเท่านั้น ชื่อแอตทริบิวต์ หากปัญหาเกิดจากแอตทริบิวต์เดียว |
reporting_context |
เอาต์พุตเท่านั้น ปลายทางที่เกิดปัญหา |
description |
เอาต์พุตเท่านั้น คำอธิบายปัญหาสั้นๆ เป็นภาษาอังกฤษ |
detail |
เอาต์พุตเท่านั้น คำอธิบายปัญหาโดยละเอียดเป็นภาษาอังกฤษ |
documentation |
เอาต์พุตเท่านั้น URL ของหน้าเว็บที่จะช่วยแก้ปัญหานี้ได้ |
applicable_countries[] |
เอาต์พุตเท่านั้น รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่เกี่ยวข้องกับข้อเสนอ |
ความรุนแรง
ความรุนแรงของปัญหา
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
ไม่ได้ระบุ |
NOT_IMPACTED |
ปัญหานี้แสดงถึงคำเตือนและไม่มีผลโดยตรงต่อการโปรโมต |
DEMOTED |
โปรโมชันถูกลดระดับและมีแนวโน้มสูงที่จะถูกจำกัดประสิทธิภาพในผลการค้นหา |
DISAPPROVED |
ปัญหาไม่อนุมัติโปรโมชัน |
RedemptionChannel
ช่องทางของโปรโมชัน
Enum | |
---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
บ่งบอกว่าไม่ได้ระบุช่อง |
IN_STORE |
บ่งบอกว่าช่องอยู่ในร้านค้าแล้ว ซึ่งเหมือนกับช่อง local ที่ใช้สำหรับ products |
ONLINE |
บ่งบอกว่าช่องออนไลน์อยู่ |
StoreApplicability
รหัสร้านค้าหรือรายการรหัสร้านค้าที่ใช้โปรโมชัน สำหรับโปรโมชันโฆษณาสินค้าคงคลังในร้านเท่านั้น
Enum | |
---|---|
STORE_APPLICABILITY_UNSPECIFIED |
ไม่ทราบรหัสร้านค้าที่ใช้โปรโมชัน |
ALL_STORES |
โปรโมชันใช้ได้กับร้านค้าทั้งหมด |
SPECIFIC_STORES |
โปรโมชันใช้ได้กับร้านค้าที่ระบุเท่านั้น |