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 đã tạo ra: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

Yêu cầu HTTP

POST https://googleads.googleapis.com/v16/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.
}
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 mục tiêu địa lý được trả về.
countryCode

string

Mục tiêu địa lý được trả về bị giới hạn ở mã quốc gia này.
Trường hợp query. Bắt buộc. Bộ chọn hằng số mục tiêu địa lý. query chỉ có thể là một trong những trạng thái sau:
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ý để lọc.

Nội dung phản hồi

Tin nhắn phản hồ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)
    }
  ]
}
Trường
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

Đề xuất hằng số về mục tiêu đị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 địa điểm.

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

string

Danh sách tên địa điểm.

GeoTargets

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

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

string

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

GeoTargetConstantSuggestion

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

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

object (GeoTargetConstant)

Kết quả GeoTargetConstant.
geoTargetConstantParents[]

object (GeoTargetConstant)

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

string

Ngôn ngữ GeoTargetConstantConstantGợi ý hiện đang được dịch sang. Tiêu chí nhắm mục tiêu ảnh hưởng đến tên của trường mục tiêu địa lý. Ví dụ: nếu ngôn ngữ=en, thì tên=Tây Ban Nha. Nếu ngôn ngữ=es, thì tên=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ố lượng 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ý.