Method: listPlannableLocations

Trả về danh sách các vị trí có thể lập kế hoạch (ví dụ: quốc gia).

Danh sách các lỗi được tạo ra: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Yêu cầu HTTP

POST https://googleads.googleapis.com/v14:listPlannableLocations

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 phải trống.

Nội dung phản hồi

Danh sách các vị trí có thể lập kế hoạch.

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 
{
  "plannableLocations": [
    {
      object (PlannableLocation)
    }
  ]
}
Các trường
plannableLocations[]

object (PlannableLocation)

Danh sách các địa điểm có sẵn để lập kế hoạch. Hãy truy cập vào https://developers.google.com/google-ads/api/reference/data/geotargets để biết các vị trí mẫu.

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.

PlannableLocation

Vị trí có thể lập kế hoạch: quốc gia, khu vực thành phố lớn, tỉnh, v.v.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "name": string,
  "parentCountryId": string,
  "countryCode": string,
  "locationType": string
}
Các trường
id

string

Giá trị nhận dạng vị trí.
name

string

Tên vị trí duy nhất bằng tiếng Anh.
parentCountryId

string (int64 format)

Quốc gia mẹ (không xuất hiện nếu vị trí là một quốc gia). Nếu có, sẽ luôn là ID GeoTargetConstant. Thông tin bổ sung như tên quốc gia do ReachPlanService.ListPlannableLocations hoặc GoogleAdsService.Search/SearchStream cung cấp.
countryCode

string

Mã quốc gia theo ISO-3166-1 alpha-2 được liên kết với vị trí.
locationType

string

Loại vị trí. Các loại vị trí tương ứng với targetType được trả về bằng cách tìm kiếm loại vị trí trong GoogleAdsService.Search/SearchStream.