Method: geoTargetConstants.suggest

Trả về các đề xuất GeoTargetConstant theo tên vị trí hoặc theo tên tài nguyên.

Danh sách các lỗi đã gửi: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng 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.
}
Các trường
locale

string

Nếu có thể, các mục tiêu địa lý được trả về sẽ được dịch bằng ngôn ngữ này. Nếu không, en sẽ được sử dụng theo mặc định. Giá trị này cũng được dùng làm gợi ý cho các mục tiêu địa lý được trả về.
countryCode

string

Các mục tiêu theo vị trí địa lý được trả về bị hạn chế theo mã quốc gia này.
Trường nhóm query. Bắt buộc. Bộ chọn hằng số mục tiêu theo địa lý. query chỉ có thể là một trong những trạng thái sau đây:
locationNames

object (LocationNames)

Tên vị trí để tìm kiếm. Bạn có thể đặt tối đa 25 tên.
geoTargets

object (GeoTargets)

Tên tài nguyên hằng số nhắm mục tiêu theo địa lý cần lọc.

Nội dung phản hồi

Tin nhắn trả lời cho GeoTargetConstantService.SuggestGeoTargetConstants.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "geoTargetConstantSuggestions": [
    {
      object (GeoTargetConstantSuggestion)
    }
  ]
}
Các trường
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

Đề xuất hằng số nhắm mục tiêu theo vị trí địa lý.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

LocationNames

Danh sách tên vị trí.

Biểu diễn dưới dạng JSON 
{
  "names": [
    string
  ]
}
Các trường
names[]

string

Danh sách tên vị trí.

GeoTargets

Danh sách tên tài nguyên hằng số nhắm mục tiêu theo địa lý.

Biểu diễn dưới dạng JSON 
{
  "geoTargetConstants": [
    string
  ]
}
Các trường
geoTargetConstants[]

string

Danh sách tên tài nguyên hằng số nhắm mục tiêu theo địa lý.

GeoTargetConstantSuggestion

Đề xuất hằng số nhắm mục tiêu theo địa lý.

Biểu diễn dưới dạng JSON 
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
Các trường
geoTargetConstant

object (GeoTargetConstant)

Kết quả GeoTargetConstant.
geoTargetConstantParents[]

object (GeoTargetConstant)

Danh sách gốc của hằng số mục tiêu địa lý.
locale

string

Ngôn ngữ GeoTargetConstantConstantion này hiện đang được dịch sang. Giá trị này ảnh hưởng đến tên của các trường mục tiêu địa lý. Ví dụ: nếu locale=en, thì name=Spanish. Nếu ngôn ngữ=es, thì name=España. Ngôn ngữ mặc định sẽ được trả về nếu không có bản dịch nào cho ngôn ngữ trong yêu cầu.
reach

string (int64 format)

Số người dùng ước tính sẽ được nhắm mục tiêu, được làm tròn đến số 100 gần nhất.
searchTerm

string

Nếu yêu cầu được tìm kiếm theo tên vị trí, thì đây là tên vị trí khớp với mục tiêu địa lý.