Method: accounts.adSources.list
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Liệt kê các nguồn quảng cáo.
Yêu cầu HTTP
GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adSources
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 nguồn quảng cáo này. Định dạng: accounts/{publisherId}
|
Tham số truy vấn
Tham số |
pageSize |
integer
Số lượng nguồn quảng cáo tối đa cần trả về. Nếu bạn không chỉ định hoặc là 0, hệ thống sẽ trả về tối đa 10.000 nguồn quảng cáo. Giá trị tối đa là 20.000; những giá trị trên 10.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 adSources.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
Nội dung phản hồi cho ListAdSourcesRequest.
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 |
{
"adSources": [
{
object (AdSource )
}
],
"nextPageToken": string
} |
Trường |
adSources[] |
object (AdSource )
Nguồn quảng cáo.
|
nextPageToken |
string
Dùng để đặt pageToken trong ListAdSourcesRequest 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.readonly
https://www.googleapis.com/auth/admob.report
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
AdSource
Định nghĩa về nguồn quảng cáo dàn xếp.
Biểu diễn dưới dạng JSON |
{
"name": string,
"adSourceId": string,
"title": string
} |
Trường |
name |
string
Tên tài nguyên của nguồn quảng cáo này. Định dạng là: accounts/{publisherId}/adSources/{adSourceId}
|
adSourceId |
string
Mã của nguồn quảng cáo này.
|
title |
string
Tên hiển thị của nguồn quảng cáo này.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-21 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-21 UTC."],[[["\u003cp\u003eRetrieves a list of ad sources associated with a specific AdMob account.\u003c/p\u003e\n"],["\u003cp\u003eAllows pagination to retrieve large lists of ad sources using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach ad source is identified by a unique \u003ccode\u003eadSourceId\u003c/code\u003e and has a display \u003ccode\u003etitle\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access.\u003c/p\u003e\n"]]],["This document details how to list ad sources using the AdMob API. To retrieve ad sources, send a `GET` request to `https://admob.googleapis.com/v1beta/{parent=accounts/*}/adSources`, specifying the account ID in the `parent` path parameter. Optional query parameters include `pageSize` (maximum ad sources returned) and `pageToken` (for pagination). The request body must be empty. The response includes a list of `adSources` with their `name`, `adSourceId`, and `title` and a `nextPageToken` for further pages.\n"],null,["# Method: accounts.adSources.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAdSourcesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [AdSource](#AdSource)\n - [JSON representation](#AdSource.SCHEMA_REPRESENTATION)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nList the ad sources.\n\n### HTTP request\n\n`GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adSources`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent which owns this collection of ad sources. Format: accounts/{publisherId} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of ad sources to return. If unspecified or 0, at most 10,000 ad sources will be returned. The maximum value is 20,000; values above 10,000 will be coerced to 20,000. |\n| `pageToken` | `string` A page token, received from a previous `adSources.list` call. Provide this to retrieve the subsequent page. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the ListAdSourcesRequest.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"adSources\": [ { object (/admob/api/reference/rest/v1beta/accounts.adSources/list#AdSource) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `adSources[]` | `object (`[AdSource](/admob/api/reference/rest/v1beta/accounts.adSources/list#AdSource)`)` The ad sources. |\n| `nextPageToken` | `string` Used to set the `pageToken` in the `ListAdSourcesRequest` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admob.readonly`\n- `\n https://www.googleapis.com/auth/admob.report`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nAdSource\n--------\n\nDefinition of a mediation ad source.\n\n| JSON representation |\n|-------------------------------------------------------------------|\n| ``` { \"name\": string, \"adSourceId\": string, \"title\": string } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name of this ad source. Format is: accounts/{publisherId}/adSources/{adSourceId} |\n| `adSourceId` | `string` ID of this ad source. |\n| `title` | `string` Display name of this ad source. |"]]