Method: geoTargetConstants.suggest

แสดงคำแนะนำ GeoTargetConstant ตามชื่อตำแหน่งหรือตามชื่อทรัพยากร

รายการข้อผิดพลาด: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

คำขอ HTTP

POST https://googleads.googleapis.com/v17/geoTargetConstants:suggest

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

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

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

การแสดง JSON 
{
  "locale": string,
  "countryCode": string,

  // Union field query can be only one of the following:
  "locationNames": {
    object (LocationNames)
  },
  "geoTargets": {
    object (GeoTargets)
  }
  // End of list of possible types for union field query.
}
ช่อง
locale

string

หากเป็นไปได้ เป้าหมายทางภูมิศาสตร์ที่ส่งกลับจะได้รับการแปลโดยใช้สถานที่นี้ หากไม่เป็นเช่นนั้น ระบบจะใช้ en โดยค่าเริ่มต้น ค่านี้ยังใช้เป็นคำแนะนำสำหรับเป้าหมายทางภูมิศาสตร์ที่ส่งกลับด้วย
countryCode

string

เป้าหมายทางภูมิศาสตร์ที่แสดงผลถูกจำกัดไว้เฉพาะรหัสประเทศนี้
ช่องการรวม query ต้องระบุ ตัวเลือกค่าคงที่เป้าหมายทางภูมิศาสตร์ query ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
locationNames

object (LocationNames)

ชื่อสถานที่ที่จะค้นหา โดยสามารถตั้งชื่อได้สูงสุด 25 ชื่อ
geoTargets

object (GeoTargets)

ชื่อทรัพยากรคงที่ของเป้าหมายทางภูมิศาสตร์ที่จะกรอง

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

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

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

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

object (GeoTargetConstantSuggestion)

คำแนะนำคงที่ของเป้าหมายทางภูมิศาสตร์

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

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

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

LocationNames

รายการชื่อสถานที่ตั้ง

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

string

รายการชื่อสถานที่ตั้ง

GeoTargets

รายการชื่อทรัพยากรคงที่ของเป้าหมายทางภูมิศาสตร์

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

string

รายการชื่อทรัพยากรคงที่ของเป้าหมายทางภูมิศาสตร์

GeoTargetConstantSuggestion

คำแนะนำคงที่ของเป้าหมายทางภูมิศาสตร์

การแสดง JSON 
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
ช่อง
geoTargetConstant

object (GeoTargetConstant)

ผลลัพธ์ GeoTargetConstant
geoTargetConstantParents[]

object (GeoTargetConstant)

รายการระดับบนสุดของค่าคงที่เป้าหมายทางภูมิศาสตร์
locale

string

ภาษาที่ GeoTargetConstantSuggestion นี้แปลอยู่ในปัจจุบัน การตั้งค่านี้ส่งผลต่อชื่อฟิลด์เป้าหมายทางภูมิศาสตร์ เช่น ถ้า locale=en ให้ใช้ name=Spain หากเป็น locale=es ให้ใช้ name=España ระบบจะแสดงผลภาษาเริ่มต้นหากไม่มีคำแปลสำหรับภาษาในคำขอ
reach

string (int64 format)

จำนวนประชากรผู้ใช้โดยประมาณที่จะถูกกำหนดเป้าหมาย โดยปัดเศษให้เป็นตัวเลข 100 ที่ใกล้เคียงที่สุด
searchTerm

string

หากคำขอค้นหาตามชื่อสถานที่ตั้ง นี่คือชื่อสถานที่ตั้งที่ตรงกับเป้าหมายทางภูมิศาสตร์