Method: geoTargetConstants.suggest

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

รายการข้อผิดพลาดที่มีการส่ง: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

คำขอ HTTP

POST https://googleads.googleapis.com/v14/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

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

string (int64 format)

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

string

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