Method: accounts.adSources.adapters.list

Liệt kê các bộ chuyển đổi của nguồn quảng cáo.

Yêu cầu HTTP

GET https://admob.googleapis.com/v1beta/{parent=accounts/*/adSources/*}/adapters

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

Tham số đường dẫn

Tham số
parent

string

Bắt buộc. Nhà xuất bản mẹ sở hữu tập hợp bộ chuyển đổi này. Định dạng: accounts/{publisherId}/adSources/{adSourceId}

Tham số truy vấn

Tham số
pageSize

integer

Số lượng bộ chuyển đổi tối đa cần trả về. Nếu bạn không chỉ định hoặc 0, hệ thống sẽ trả về tối đa 10.000 bộ chuyển đổi. Giá trị tối đa là 20.000; nếu trên 20.000 thì bị buộc thành 20.000.
pageToken

string

Mã thông báo trang, nhận được từ lệnh gọi adapters.list trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

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 cho ListAdaptersRequest.

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

object (Adapter)

Bộ chuyển đổi.
nextPageToken

string

Dùng để đặt pageToken trong ListAdapterRequest nhằm truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/admob.monetization
  • https://www.googleapis.com/auth/admob.readonly

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

Adapter (Người chuyển thể)

Mô tả các bộ chuyển đổi mà mỗi nguồn quảng cáo dàn xếp hỗ trợ.

Các bộ chuyển đổi tương ứng với một phương thức triển khai SDK cụ thể của nguồn quảng cáo, và mỗi bộ chuyển đổi được liên kết với một nền tảng duy nhất cùng với danh sách các định dạng đơn vị quảng cáo được hỗ trợ. Bộ chuyển đổi cũng có thể yêu cầu thiết lập một số cấu hình để thực hiện yêu cầu quảng cáo. Bạn có thể chỉ định cấu hình trong AdUnitMapping bằng cách đặt cặp khoá/giá trị adUnitConfigurations. Ví dụ: có thể sử dụng adUnitConfigurations để chuyển các mã nhận dạng khác nhau đến SDK bên thứ ba của bộ chuyển đổi.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "adapterId": string,
  "title": string,
  "platform": string,
  "formats": [
    string
  ],
  "adapterConfigMetadata": [
    {
      object (AdapterConfigMetadata)
    }
  ]
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của bộ chuyển đổi. Định dạng là:

accounts/{publisherId}/adSources/{adSourceId}/adapters/{adapterId}.
adapterId

string

Chỉ có đầu ra. Mã của bộ chuyển đổi này. Mã này được dùng để đặt adapterId.
title

string

Chỉ có đầu ra. Tên hiển thị của bộ chuyển đổi này.
platform

string

Chỉ có đầu ra. Nền tảng ứng dụng dành cho thiết bị di động được bộ chuyển đổi này hỗ trợ.

Các giá trị được hỗ trợ là: IOS, ANDROID, WINDOWS_PHONE
formats[]

string

Chỉ có đầu ra. Cho biết các định dạng của đơn vị quảng cáo được bộ chuyển đổi này hỗ trợ.
adapterConfigMetadata[]

object (AdapterConfigMetadata)

Chỉ có đầu ra. Siêu dữ liệu cấu hình được liên kết với bộ chuyển đổi này.

AdapterConfigMetadata

Siêu dữ liệu cấu hình được liên kết với bộ chuyển đổi này. Các thẻ này được dùng để xác định adUnitConfigurations được liên kết với AdUnitMappings cho bộ chuyển đổi này.

Biểu diễn dưới dạng JSON 
{
  "adapterConfigMetadataId": string,
  "adapterConfigMetadataLabel": string,
  "isRequired": boolean
}
Trường
adapterConfigMetadataId

string

Chuỗi này dùng để điền khoá của adUnitConfigurations.
adapterConfigMetadataLabel

string

Tên của siêu dữ liệu cấu hình bộ chuyển đổi.
isRequired

boolean

Liệu siêu dữ liệu này có bắt buộc để định cấu hình các AdUnitMappings hay không.