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. Phần tử mẹ sở hữu bộ sưu tập bộ chuyển đổi này. Định dạng: accounts/{publisherId}/adSources/{adSourceId}

Tham số truy vấn

Thông 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 chỉ định 0, thì tối đa 10.000 bộ chuyển đổi sẽ được trả về. Giá trị tối đa là 20.000; các giá trị trên 20.000 sẽ được chuyển đổi thành 20.000.
pageToken

string

Mã thông báo trang nhận được từ một lệnh gọi adapters.list trước đó. Cung cấp thông tin 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 để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, 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 OAuth 2.0 Overview.

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

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

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

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

string

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

object (AdapterConfigMetadata)

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

AdapterConfigMetadata

Siêu dữ liệu cấu hình liên kết với bộ chuyển đổi này. Chúng đượ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

Tham số 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

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