Method: mediaPlanners.list

Liệt kê tất cả tài khoản của công cụ lập kế hoạch truyền thông mà người gọi có quyền truy cập.

Đối với người tuyển chọn, thao tác này sẽ trả về tất cả những người lập kế hoạch truyền thông đã chấp nhận các điều khoản dành cho người tuyển chọn.

Đối với các tài khoản khác, việc cố gắng liệt kê các nhà lập kế hoạch truyền thông sẽ báo lỗi.

Yêu cầu HTTP

GET https://curationpartners.googleapis.com/v1/mediaPlanners

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

Tham số truy vấn

Thông số
pageSize

integer

Số lượng tối đa các nhà lập kế hoạch truyền thông cần trả về. Nếu không chỉ định, tối đa 100 nhà lập kế hoạch truyền thông sẽ được trả về. Giá trị tối đa là 500; các giá trị trên 500 sẽ được chuyển đổi thành 500.
pageToken

string

Không bắt buộc. Mã thông báo xác định một trang kết quả mà máy chủ sẽ trả về.Giá trị này được nhận từ một lệnh gọi mediaPlanners.list trước đó trong ListMediaPlannersResponse.nextPageToken.
filter

string

Chuỗi truy vấn không bắt buộc bằng cách sử dụng cú pháp lọc danh sách Cloud API. Các cột được hỗ trợ để lọc là:

  • name
  • displayName
  • ancestorNames

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

Phản hồi chứa thông tin tài khoản của công cụ lập kế hoạch truyền thông.

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 
{
  "mediaPlanners": [
    {
      object (MediaPlanner)
    }
  ],
  "nextPageToken": string
}
Trường
mediaPlanners[]

object (MediaPlanner)

Danh sách chuyên viên kế hoạch truyền thông.
nextPageToken

string

Một mã thông báo có thể được truyền đến lệnh gọi tiếp theo cho phương thức mediaPlanners.list để truy xuất trang kết quả tiếp theo trong ListMediaPlannersRequest.page_token.

Phạm vi uỷ quyền

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

  • https://www.googleapis.com/auth/curation-partners

MediaPlanner

Đại diện cho tài khoản chuyên viên lập kế hoạch truyền thông.

Biểu diễn dưới dạng JSON 
{
  "accountId": string,
  "name": string,
  "displayName": string,
  "ancestorNames": [
    string
  ]
}
Trường
accountId
(deprecated)

string

Chỉ có đầu ra. Mã tài khoản của nhà lập kế hoạch truyền thông.
name

string

Giá trị nhận dạng. Tên tài nguyên duy nhất của công cụ lập kế hoạch truyền thông. Định dạng: mediaPlanners/{mediaPlannerAccountId}. Có thể dùng để lọc phản hồi của phương thức mediaPlanners.list.
displayName

string

Chỉ có đầu ra. Tên hiển thị của nhà lập kế hoạch truyền thông. Có thể dùng để lọc phản hồi của phương thức [mediaPlanners.list][google.ads.authorizedbuyers.marketplace.v1main.MediaPlanners.ListMediaPlanners].
ancestorNames[]

string

Chỉ có đầu ra. Tên của đối tượng cấp trên của chuyên viên kế hoạch truyền thông. Định dạng: mediaPlanners/{mediaPlannerAccountId}. Có thể dùng để lọc phản hồi của phương thức mediaPlanners.list.