Method: customers.suggestBrands

Rpc เพื่อแสดงรายชื่อแบรนด์ที่ตรงกันตามคำนำหน้าสำหรับลูกค้ารายนี้

คำขอ HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}:suggestBrands

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

ต้องระบุ รหัสของลูกค้าที่จะใช้การดำเนินการแนะนำแบรนด์

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
ช่อง
selectedBrands[]

string

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

string

ต้องระบุ คํานําหน้าของชื่อแบรนด์

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ BrandSuggestionService.SuggestBrands

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
ช่อง
brands[]

object (BrandSuggestion)

สร้างการแนะนำแบรนด์ของแบรนด์ที่ยืนยันแล้วสำหรับคำนำหน้าที่ระบุ

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

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/adwords

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

BrandSuggestion

ข้อมูลการแนะนำแบรนด์

การแสดง JSON 
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
ช่อง
id

string

รหัสสำหรับแบรนด์ โดยควรเป็น CKG MID สําหรับแบรนด์ที่ได้รับการยืนยัน/ขอบเขตระดับโลก
name

string

ชื่อแบรนด์
urls[]

string

URL ที่ระบุแบรนด์โดยไม่ซ้ำกัน
state

enum (BrandState)

สถานะปัจจุบันของแบรนด์

BrandState

การแจงนับสถานะแบรนด์ต่างๆ

Enum
UNSPECIFIED ไม่ได้ระบุค่า
UNKNOWN ใช้สำหรับผลลัพธ์เท่านั้น แสดงถึงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED แบรนด์ได้รับการยืนยันและพร้อมจำหน่ายทั่วโลก
DEPRECATED แบรนด์พร้อมใช้งานทั่วโลกในอดีต แต่ไม่ใช่แบรนด์ที่ถูกต้องอีกต่อไป (อิงตามเกณฑ์ทางธุรกิจ)
UNVERIFIED แบรนด์ไม่ได้รับการยืนยันและกำหนดขอบเขตลูกค้า แต่ลูกค้าสามารถเลือกแบรนด์ได้ (เฉพาะผู้ที่ส่งคำขอสำหรับแบรนด์เดียวกัน) สำหรับการกำหนดเป้าหมาย
APPROVED เป็นแบรนด์ที่กําหนดขอบเขตระดับลูกค้า (ไม่ได้รับการยืนยัน) ซึ่งได้รับอนุมัติจากธุรกิจและเพิ่มลงในรายการทั่วโลก ควรใช้ CKG MID ที่ได้รับมอบหมายแทนรายการนี้
CANCELLED เป็นแบรนด์ที่กําหนดขอบเขตระดับลูกค้า (ไม่ได้รับการยืนยัน) แต่ลูกค้ายกเลิกคำขอและรหัสแบรนด์นี้จะใช้ไม่ได้อีกต่อไป
REJECTED เป็นแบรนด์ที่กําหนดขอบเขตระดับลูกค้า (ไม่ได้รับการยืนยัน) แต่ทีมธุรกิจภายในปฏิเสธคําขอและรหัสแบรนด์นี้ใช้ไม่ได้แล้ว