Method: accounts.adSources.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מציינים את מקורות המודעות.
בקשת HTTP
GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adSources
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים |
parent |
string
חובה. ההורה שהוא הבעלים של אוסף מקורות המודעות הזה. פורמט: accounts/{publisherId}
|
פרמטרים של שאילתה
פרמטרים |
pageSize |
integer
המספר המקסימלי של מקורות מודעות שצריך להחזיר. אם לא צוין 0, יוחזרו 10,000 מקורות מודעות לכל היותר. הערך המקסימלי הוא 20,000; ערכים מעל 10,000 יקובצו ל-20,000.
|
pageToken |
string
אסימון דף, שהתקבל מקריאה קודמת ב-adSources.list . צריך לספק את הכתובת הזו כדי לאחזר את הדף הבא.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תגובה ל-ListAdSourcesRequest.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
{
"adSources": [
{
object (AdSource )
}
],
"nextPageToken": string
} |
שדות |
adSources[] |
object (AdSource )
מקורות המודעות.
|
nextPageToken |
string
היא משמשת להגדרת pageToken ב-ListAdSourcesRequest לאחזור הדף הבא. אם השדה הזה יושמט, אין דפים נוספים.
|
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/admob.readonly
https://www.googleapis.com/auth/admob.report
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
AdSource
הגדרה של מקור מודעות בתהליך בחירת הרשת.
ייצוג JSON |
{
"name": string,
"adSourceId": string,
"title": string
} |
שדות |
name |
string
שם המשאב של מקור המודעות הזה. הפורמט הוא: accounts/{publisherId}/adSources/{adSourceId}
|
adSourceId |
string
המזהה של מקור המודעות הזה.
|
title |
string
השם המוצג של מקור המודעות הזה.
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-21 (שעון UTC).
[null,null,["עדכון אחרון: 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. |"]]