REST Resource: accounts.promotions

แหล่งข้อมูล: โปรโมชัน

แสดงถึงโปรโมชัน ดูรายละเอียดเพิ่มเติมได้ที่บทความต่อไปนี้

แอตทริบิวต์อินพุตโปรโมชันที่จําเป็นเพื่อให้ผ่านการตรวจสอบความถูกต้องของข้อมูลมีคำจำกัดความหลักๆ ดังนี้

หลังจากแทรกและอัปเดตข้อมูลโปรโมชันแล้ว ระบบอาจใช้เวลา 2-3 นาทีจึงจะเรียกข้อมูลโปรโมชันสุดท้ายได้

การแสดง JSON 
{
  "name": string,
  "promotionId": string,
  "contentLanguage": string,
  "targetCountry": string,
  "redemptionChannel": [
    enum (RedemptionChannel)
  ],
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "promotionStatus": {
    object (PromotionStatus)
  },
  "versionNumber": string
}
ช่อง
name

string

ตัวระบุ ชื่อของโปรโมชัน รูปแบบ: accounts/{account}/promotions/{promotion}
promotionId

string

ต้องระบุ รหัสโปรโมชันที่ผู้ใช้ระบุเพื่อระบุโปรโมชันนั้นๆ โดยไม่ซ้ำกัน ปฏิบัติตามข้อกำหนดขั้นต่ำเพื่อป้องกันไม่ให้มีการไม่อนุมัติโปรโมชัน
contentLanguage

string

ต้องระบุ รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรของโปรโมชัน

โปรโมชันมีให้บริการในบางภาษาเท่านั้น
targetCountry

string

ต้องระบุ ประเทศเป้าหมายที่ใช้เป็นส่วนหนึ่งของตัวระบุที่ไม่ซ้ำ แสดงเป็นรหัสเขตแดน CLDR

โปรโมชันใช้ได้เฉพาะในบางประเทศ ข้อมูลที่แสดงฟรีและโฆษณา Shopping โฆษณาสินค้าคงคลังในร้าน
redemptionChannel[]

enum (RedemptionChannel)

ต้องระบุ ช่องทางการแลกรับสิทธิ์สำหรับโปรโมชัน ต้องมีแชแนลอย่างน้อย 1 รายการ
dataSource

string

เอาต์พุตเท่านั้น แหล่งข้อมูลหลักของโปรโมชัน
attributes

object (Attributes)

ไม่บังคับ รายการแอตทริบิวต์โปรโมชัน
customAttributes[]

object (CustomAttribute)

ไม่บังคับ รายการแอตทริบิวต์ที่กำหนดเอง (ผู้ขายระบุ) นอกจากนี้ยังใช้ส่งแอตทริบิวต์ของข้อกำหนดในการจัดทำข้อมูลในรูปแบบทั่วไป (เช่น { "name": "size type", "value": "regular" }) ได้ด้วย ซึ่งมีประโยชน์สำหรับการส่งแอตทริบิวต์ที่ API ไม่ได้แสดงอย่างชัดเจน
promotionStatus

object (PromotionStatus)

เอาต์พุตเท่านั้น สถานะของการโปรโมต ปัญหาการตรวจสอบข้อมูล ซึ่งก็คือข้อมูลเกี่ยวกับการโปรโมตที่ประมวลผลแบบไม่พร้อมกัน
versionNumber

string (int64 format)

ไม่บังคับ แสดงเวอร์ชันที่มีอยู่ (ความใหม่) ของโปรโมชัน ซึ่งสามารถใช้เพื่อรักษาลําดับที่ถูกต้องเมื่อมีการอัปเดตหลายรายการพร้อมกัน

หากตั้งค่าไว้ ระบบจะป้องกันไม่ให้แทรกเมื่อหมายเลขเวอร์ชันต่ำกว่าหมายเลขเวอร์ชันปัจจุบันของโปรโมชันที่มีอยู่ คุณสามารถแทรก versionNumber ใหม่ได้ (เช่น รีเฟรชโปรโมชันหลังจากผ่านไป 30 วัน)

หากมีการป้องกันการดําเนินการ ระบบจะแสดงข้อยกเว้นที่ยกเลิก

RedemptionChannel

ช่องทางของโปรโมชัน

Enum
REDEMPTION_CHANNEL_UNSPECIFIED บ่งบอกว่าไม่ได้ระบุแชแนล
IN_STORE บ่งบอกว่าช่องมีให้บริการใน Store ซึ่งช่องนี้เหมือนกับช่อง local ที่ใช้ในการเผยแพร่ products
ONLINE บ่งบอกว่าช่องออนไลน์อยู่

Attributes

แอตทริบิวต์

การแสดง JSON 
{
  "productApplicability": enum (ProductApplicability),
  "offerType": enum (OfferType),
  "genericRedemptionCode": string,
  "longTitle": string,
  "couponValueType": enum (CouponValueType),
  "promotionDestinations": [
    enum (DestinationEnum)
  ],
  "itemIdInclusion": [
    string
  ],
  "brandInclusion": [
    string
  ],
  "itemGroupIdInclusion": [
    string
  ],
  "productTypeInclusion": [
    string
  ],
  "itemIdExclusion": [
    string
  ],
  "brandExclusion": [
    string
  ],
  "itemGroupIdExclusion": [
    string
  ],
  "productTypeExclusion": [
    string
  ],
  "minimumPurchaseAmount": {
    object (Price)
  },
  "minimumPurchaseQuantity": string,
  "limitQuantity": string,
  "limitValue": {
    object (Price)
  },
  "percentOff": string,
  "moneyOffAmount": {
    object (Price)
  },
  "getThisQuantityDiscounted": string,
  "freeGiftValue": {
    object (Price)
  },
  "freeGiftDescription": string,
  "freeGiftItemId": string,
  "promotionEffectiveTimePeriod": {
    object (Interval)
  },
  "promotionDisplayTimePeriod": {
    object (Interval)
  },
  "storeApplicability": enum (StoreApplicability),
  "storeCodesInclusion": [
    string
  ],
  "storeCodesExclusion": [
    string
  ],
  "promotionUrl": string
}
ช่อง
productApplicability

enum (ProductApplicability)

ต้องระบุ การใช้โปรโมชันกับผลิตภัณฑ์ทั้งหมดหรือเฉพาะผลิตภัณฑ์ที่เฉพาะเจาะจง
offerType

enum (OfferType)

ต้องระบุ ประเภทของโปรโมชัน ใช้แอตทริบิวต์นี้เพื่อระบุว่าลูกค้าต้องใช้รหัสคูปองเพื่อแลกสิทธิ์โปรโมชันหรือไม่
genericRedemptionCode

string

ไม่บังคับ รหัสแลกรับข้อเสนอทั่วไปสำหรับโปรโมชัน ใช้กับช่อง offerType และต้องเป็นไปตามข้อกำหนดขั้นต่ำ
longTitle

string

ต้องระบุ ชื่อแบบยาวของโปรโมชัน
couponValueType

enum (CouponValueType)

ต้องระบุ แอตทริบิวต์ประเภทมูลค่าของคูปองเพื่อระบุประเภทโปรโมชันที่คุณใช้อยู่ ต้องระบุแอตทริบิวต์บางรายการ ทั้งนี้ขึ้นอยู่กับประเภทมูลค่าของคูปองที่คุณเลือก
promotionDestinations[]

enum (DestinationEnum)

ต้องระบุ รายการปลายทางที่ใช้โปรโมชันได้ หากไม่ได้ระบุปลายทางด้วยการใส่ค่าที่รองรับในแหล่งข้อมูล โปรโมชันจะแสดงในโฆษณา Shopping และข้อมูลที่แสดงฟรีโดยค่าเริ่มต้น

ก่อนหน้านี้คุณอาจส่งค่า Shopping Actions, Surfaces across Google และ Local surfaces across Google เป็นปลายทางสำหรับผลิตภัณฑ์ หากต้องการแสดงค่าเหล่านี้ ให้ใช้ FREE_LISTINGS, FREE_LOCAL_LISTINGS, LOCAL_INVENTORY_ADS ดูรายละเอียดเพิ่มเติมได้ที่ปลายทางโปรโมชัน
itemIdInclusion[]

string

ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสสินค้าสำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ productApplicability ของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชันเป็น specific_products
brandInclusion[]

string

ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามแบรนด์สำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ productApplicability ของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชันเป็น specific_products
itemGroupIdInclusion[]

string

ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสกลุ่มสินค้าสำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ [productApplicability] ของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชันเป็น specific_products
productTypeInclusion[]

string

ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามประเภทผลิตภัณฑ์สำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ productApplicability ของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชันเป็น specific_products
itemIdExclusion[]

string

ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นรหัสสินค้าสำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ productApplicability ของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชันเป็น specific_products
brandExclusion[]

string

ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นแบรนด์สำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ productApplicability ของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชันเป็น specific_products
itemGroupIdExclusion[]

string

ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสกลุ่มสินค้า แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ productApplicability ของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชันเป็น specific_products ยกเว้นสำหรับโปรโมชัน
productTypeExclusion[]

string

ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นประเภทผลิตภัณฑ์สำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ productApplicability ของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชันเป็น specific_products
minimumPurchaseAmount

object (Price)

ไม่บังคับ ยอดสั่งซื้อขั้นต่ำสำหรับโปรโมชัน
minimumPurchaseQuantity

string (int64 format)

ไม่บังคับ จำนวนการซื้อขั้นต่ำสำหรับโปรโมชัน
limitQuantity

string (int64 format)

ไม่บังคับ จำนวนการซื้อสูงสุดสำหรับโปรโมชัน
limitValue

object (Price)

ไม่บังคับ ราคาผลิตภัณฑ์สูงสุดสำหรับโปรโมชัน
percentOff

string (int64 format)

ไม่บังคับ เปอร์เซ็นต์ส่วนลดที่มีให้ในโปรโมชัน
moneyOffAmount

object (Price)

ไม่บังคับ จำนวนเงินส่วนลดที่เสนอในโปรโมชัน
getThisQuantityDiscounted

string (int64 format)

ไม่บังคับ จํานวนสินค้าที่ลดราคาในโปรโมชัน ระบบจะตั้งค่าแอตทริบิวต์เมื่อ couponValueType เท่ากับ buy_m_get_n_money_off หรือ buy_m_get_n_percent_off
freeGiftValue

object (Price)

ไม่บังคับ มูลค่าของขวัญฟรีสำหรับโปรโมชัน
freeGiftDescription

string

ไม่บังคับ รายละเอียดของขวัญฟรีสำหรับโปรโมชัน
freeGiftItemId

string

ไม่บังคับ รหัสสินค้าของขวัญฟรีสำหรับโปรโมชัน
promotionEffectiveTimePeriod

object (Interval)

ต้องระบุ TimePeriod การนำเสนอวันที่มีผลของโปรโมชัน แอตทริบิวต์นี้ระบุว่าสามารถทดสอบโปรโมชันในร้านค้าออนไลน์ได้ในช่วงระยะเวลานี้
promotionDisplayTimePeriod

object (Interval)

ไม่บังคับ TimePeriod การนำเสนอวันที่แสดงของโปรโมชัน แอตทริบิวต์นี้ระบุวันที่และกรอบเวลาที่โปรโมชันจะแสดงใน Google.com และโฆษณา Shopping หากไม่ได้ระบุแอตทริบิวต์ระยะเวลาที่แสดงของโปรโมชัน promotionDisplayTimePeriod ระยะเวลาที่มีผลของโปรโมชัน promotionEffectiveTimePeriod จะกำหนดวันที่และกรอบเวลาที่โปรโมชันจะแสดงใน Google.com และโฆษณา Shopping
storeApplicability

enum (StoreApplicability)

ไม่บังคับ โปรโมชันมีผลกับร้านค้าทั้งหมดหรือเฉพาะบางร้านค้า โปรโมชันโฆษณาสินค้าคงคลังในร้านจะแสดงข้อผิดพลาดหากไม่มีการนำไปใช้กับร้านค้า ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT หากตั้งค่า storeApplicability เป็น ALL_STORES และตั้งค่า storeCodesInclusion หรือ score_code_exclusion เป็นค่า
storeCodesInclusion[]

string

ไม่บังคับ รหัสร้านค้าที่จะรวมในโปรโมชัน แอตทริบิวต์ตัวกรองร้านค้าจะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ storeApplicability เป็น specific_stores

รหัสร้านค้า (รหัสร้านค้าจาก Business Profile) ของร้านค้าจริงที่ขายผลิตภัณฑ์ ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดในการจัดทำข้อมูลสินค้าคงคลังของผลิตภัณฑ์ในร้าน
storeCodesExclusion[]

string

ไม่บังคับ รหัสร้านค้าที่จะยกเว้นสำหรับโปรโมชัน แอตทริบิวต์ตัวกรองร้านค้าจะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ storeApplicability เป็น specific_stores
promotionUrl

string

ไม่บังคับ URL ไปยังหน้าในเว็บไซต์ของผู้ขายที่แสดงโปรโมชัน โปรโมชันโฆษณาสินค้าคงคลังในร้านจะแสดงข้อผิดพลาดหากไม่มี promotionUrl ระบบจะใช้ URL เพื่อยืนยันว่าโปรโมชันใช้งานและแลกสิทธิ์ได้

ProductApplicability

ผลิตภัณฑ์หรือรายการผลิตภัณฑ์ที่โปรโมชันมีผล

Enum
PRODUCT_APPLICABILITY_UNSPECIFIED ไม่ทราบผลิตภัณฑ์ที่โปรโมชันมีผล
ALL_PRODUCTS ใช้กับผลิตภัณฑ์ทั้งหมดได้
SPECIFIC_PRODUCTS ใช้กับผลิตภัณฑ์หรือรายการผลิตภัณฑ์รายการเดียวเท่านั้น

OfferType

ประเภทข้อเสนอของโปรโมชัน

Enum
OFFER_TYPE_UNSPECIFIED ประเภทข้อเสนอที่ไม่รู้จัก
NO_CODE ประเภทข้อเสนอที่ไม่มีรหัส
GENERIC_CODE ประเภทข้อเสนอที่มีรหัส ต้องระบุรหัสแลกรับข้อเสนอทั่วไปสำหรับโปรโมชันเมื่อ offerType = GENERIC_CODE

CouponValueType

ประเภทมูลค่าของคูปองของโปรโมชัน

Enum
COUPON_VALUE_TYPE_UNSPECIFIED ระบุว่าไม่ได้ระบุประเภทมูลค่าของคูปอง
MONEY_OFF ประเภทมูลค่าของคูปองเป็นส่วนลด
PERCENT_OFF ประเภทมูลค่าของคูปองเป็นเปอร์เซ็นต์ส่วนลด
BUY_M_GET_N_MONEY_OFF ประเภทมูลค่าของคูปอง "ซื้อครบ M แล้วรับส่วนลด N" ต้องแสดง minimumPurchaseQuantity และ getThisQuantityDiscounted และต้องมี moneyOffAmount ด้วย
BUY_M_GET_N_PERCENT_OFF ซื้อ M รายการ รับส่วนลด N เปอร์เซ็นต์สำหรับประเภทมูลค่าของคูปอง ต้องแสดง minimumPurchaseQuantity และ getThisQuantityDiscounted และต้องมี percent_off_percentage ด้วย
BUY_M_GET_MONEY_OFF ซื้อ M รายการและรับส่วนลดเป็นเงิน โดยต้องมี minimumPurchaseQuantity และ moneyOffAmount
BUY_M_GET_PERCENT_OFF ซื้อ M รายการและรับส่วนลดเป็นเงิน โดยต้องมี minimumPurchaseQuantity และ 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 วัน ใช้ได้กับโปรโมชันออนไลน์เท่านั้น

DestinationEnum

ค่าปลายทาง

Enum
DESTINATION_ENUM_UNSPECIFIED ไม่ได้ระบุ
SHOPPING_ADS โฆษณา Shopping
DISPLAY_ADS โฆษณา Display
LOCAL_INVENTORY_ADS โฆษณาคลังผลิตภัณฑ์ในพื้นที่
FREE_LISTINGS ข้อมูลที่แสดงฟรี
FREE_LOCAL_LISTINGS ข้อมูลผลิตภัณฑ์ในร้านที่แสดงฟรี
YOUTUBE_SHOPPING YouTube Shopping
YOUTUBE_SHOPPING_CHECKOUT การชำระเงินของ YouTube Shopping
YOUTUBE_AFFILIATE แอฟฟิลิเอตของ YouTube
FREE_VEHICLE_LISTINGS ข้อมูลยานพาหนะที่แสดงฟรี
VEHICLE_ADS โฆษณายานพาหนะ
CLOUD_RETAIL Cloud Retail
LOCAL_CLOUD_RETAIL Cloud Retail ในท้องถิ่น

StoreApplicability

รหัสร้านค้าหรือรายการรหัสร้านค้าที่โปรโมชันมีผล สำหรับโปรโมชันโฆษณาสินค้าคงคลังในร้านเท่านั้น

Enum
STORE_APPLICABILITY_UNSPECIFIED ไม่ทราบรหัสร้านค้าที่ใช้โปรโมชัน
ALL_STORES ใช้โปรโมชันกับทุกร้านค้า
SPECIFIC_STORES โปรโมชันใช้ได้กับร้านค้าที่ระบุเท่านั้น

PromotionStatus

สถานะโปรโมชัน

การแสดง JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
ช่อง
destinationStatuses[]

object (DestinationStatus)

เอาต์พุตเท่านั้น ปลายทางที่ต้องการสำหรับโปรโมชัน
itemLevelIssues[]

object (ItemLevelIssue)

เอาต์พุตเท่านั้น รายการปัญหาที่เกี่ยวข้องกับโปรโมชัน
creationDate

string (Timestamp format)

เอาต์พุตเท่านั้น วันที่สร้างโปรโมชันในรูปแบบ ISO 8601: วันที่ เวลา และออฟเซ็ต เช่น 2020-01-02T09:00:00+01:00 หรือ 2020-01-02T09:00:00Z
lastUpdateDate

string (Timestamp format)

เอาต์พุตเท่านั้น วันที่อัปเดตสถานะโปรโมชันครั้งล่าสุดในรูปแบบ ISO 8601: วันที่ เวลา และออฟเซ็ต เช่น 2020-01-02T09:00:00+01:00 หรือ 2020-01-02T09:00:00Z

DestinationStatus

สถานะของปลายทางที่ระบุ

การแสดง JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "status": enum (State)
}
ช่อง
reportingContext

enum (ReportingContextEnum)

เอาต์พุตเท่านั้น ชื่อของปลายทางของโปรโมชัน
status

enum (State)

เอาต์พุตเท่านั้น สถานะของปลายทางที่ระบุ

รัฐ

สถานะปัจจุบันของโปรโมชัน

Enum
STATE_UNSPECIFIED สถานะโปรโมชันที่ไม่รู้จัก
IN_REVIEW โปรโมชันอยู่ระหว่างตรวจสอบ
REJECTED โปรโมชันไม่ได้รับอนุมัติ
LIVE โปรโมชันได้รับอนุมัติและใช้งานได้
STOPPED ผู้ขายหยุดโปรโมชันแล้ว
EXPIRED โปรโมชันไม่ทำงานแล้ว
PENDING โปรโมชันไม่ได้หยุดลงและการตรวจสอบทั้งหมดได้รับอนุมัติแล้ว แต่วันที่ที่ใช้งานอยู่คือวันข้างหน้า

ItemLevelIssue

ปัญหาที่เกี่ยวข้องกับโปรโมชัน

การแสดง JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
ช่อง
code

string

เอาต์พุตเท่านั้น รหัสข้อผิดพลาดของปัญหา
severity

enum (Severity)

เอาต์พุตเท่านั้น ปัญหานี้ส่งผลต่อการแสดงโปรโมชันอย่างไร
resolution

string

เอาต์พุตเท่านั้น ผู้ขายสามารถแก้ไขปัญหาได้หรือไม่
attribute

string

เอาต์พุตเท่านั้น ชื่อแอตทริบิวต์ หากปัญหาเกิดจากแอตทริบิวต์รายการเดียว
reportingContext

enum (ReportingContextEnum)

เอาต์พุตเท่านั้น ปลายทางที่มีปัญหา
description

string

เอาต์พุตเท่านั้น คำอธิบายปัญหาสั้นๆ เป็นภาษาอังกฤษ
detail

string

เอาต์พุตเท่านั้น คำอธิบายปัญหาโดยละเอียดเป็นภาษาอังกฤษ
documentation

string

เอาต์พุตเท่านั้น URL ของหน้าเว็บเพื่อช่วยแก้ไขปัญหานี้
applicableCountries[]

string

เอาต์พุตเท่านั้น รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่มีปัญหากับข้อเสนอ

ความรุนแรง

ความรุนแรงของปัญหา

Enum
SEVERITY_UNSPECIFIED ไม่ได้ระบุ
NOT_IMPACTED ปัญหานี้แสดงคำเตือนและไม่มีผลกระทบโดยตรงต่อโปรโมชัน
DEMOTED โปรโมชันถูกลดระดับและมีแนวโน้มที่จะมีประสิทธิภาพจํากัดในผลการค้นหา
DISAPPROVED ปัญหาที่ส่งผลให้โปรโมชันไม่ได้รับอนุมัติ

เมธอด

get

 ดึงข้อมูลโปรโมชันจากบัญชี Merchant Center

insert

 แทรกโปรโมชันสำหรับบัญชี Merchant Center

list

 แสดงโปรโมชันในบัญชี Merchant Center