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

Các tham số
parent

string

Bắt buộc. Thành phần mẹ sở hữu bộ sưu tập trình chuyển đổi này. Định dạng: accounts/{publisherId}/adSources/{adSourceId}

Tham số truy vấn

Các 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 là 0, thì hệ thống sẽ trả về tối đa 10.000 bộ chuyển đổi. Giá trị tối đa là 20.000; các giá trị trên 20.000 sẽ 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
}
Các trường
adapters[]

object (Adapter)

Bộ chuyển đổi.
nextPageToken

string

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

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 Tổng quan về OAuth 2.0.

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

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

Bộ chuyển đổi tương ứng với cách 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 và một 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 đặt 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 giá trị/khoá adUnitConfigurations. Ví dụ: bạn có thể sử dụng adUnitConfigurations để chuyển nhiều 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)
    }
  ]
}
Các 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 mà 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 những định dạng của đơ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
}
Các trường
adapterConfigMetadataId

string

Mã 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ó cần thiết để định cấu hình AdUnitMappings hay không.