Method: accounts.adUnits.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
צריך לרשום את יחידות המודעות בחשבון AdMob שצוין.
בקשת HTTP
GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adUnits
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
| פרמטרים |
parent |
string
חובה. שם המשאב של החשבון שעבורו רוצים להציג את רשימת יחידות המודעות. לדוגמה: accounts/pub-9876543210987654
|
פרמטרים של שאילתה
| פרמטרים |
pageSize |
integer
המספר המקסימלי של יחידות מודעות שצריך להחזיר. אם לא צוין 0, יוחזרו 10,000 יחידות מודעות לכל היותר. הערך המקסימלי הוא 20,000; ערכים מעל 20,000 יקובצו ל-20,000.
|
pageToken |
string
הערך שהוחזר על ידי ListAdUnitsResponse האחרון; מציין שמדובר בהמשך לקריאה קודמת של adUnits.list, ושהמערכת צריכה להחזיר את דף הנתונים הבא.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תשובה לבקשה של יחידות המודעות.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
| ייצוג JSON |
{
"adUnits": [
{
object (AdUnit)
}
],
"nextPageToken": string
} |
| שדות |
adUnits[] |
object (AdUnit)
יחידות המודעות שהתקבלו בחשבון המבוקש.
|
nextPageToken |
string
אם השדה לא ריק, המשמעות היא שייתכן שיש יחידות מודעות נוספות לבקשה. צריך להעביר את הערך הזה בListAdUnitsRequest חדש.
|
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/admob.monetization
https://www.googleapis.com/auth/admob.readonly
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-21 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-21 (שעון UTC)."],[[["\u003cp\u003eThis page explains how to list ad units associated with a specific AdMob account using the \u003ccode\u003eadUnits.list\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe method requires the \u003ccode\u003eparent\u003c/code\u003e path parameter to specify the AdMob account and accepts optional \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters for pagination.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses provide a list of \u003ccode\u003eAdUnits\u003c/code\u003e and a \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving additional pages if available.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using either \u003ccode\u003ehttps://www.googleapis.com/auth/admob.monetization\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/admob.readonly\u003c/code\u003e OAuth scopes.\u003c/p\u003e\n"]]],["This document details how to list ad units associated with a specific AdMob account. The process involves sending a `GET` request to `https://admob.googleapis.com/v1beta/{parent=accounts/*}/adUnits`, where `parent` is the account's resource name. Optional query parameters, `pageSize` (up to 20,000) and `pageToken` (for pagination), can be included. The request body must be empty. The response includes an array of `adUnits` and a `nextPageToken` for further results. Authorization requires specific OAuth scopes.\n"],null,["# Method: accounts.adUnits.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.ListAdUnitsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nList the ad units under the specified AdMob account.\n\n### HTTP request\n\n`GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adUnits`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. Resource name of the account to list ad units for. Example: accounts/pub-9876543210987654 |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of ad units to return. If unspecified or 0, at most 10,000 ad units will be returned. The maximum value is 20,000; values above 20,000 will be coerced to 20,000. |\n| `pageToken` | `string` The value returned by the last `ListAdUnitsResponse`; indicates that this is a continuation of a prior `adUnits.list` call, and that the system should return the next page of data. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the ad units list request.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"adUnits\": [ { object (/admob/api/reference/rest/v1beta/accounts.adUnits#AdUnit) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| `adUnits[]` | `object (`[AdUnit](/admob/api/reference/rest/v1beta/accounts.adUnits#AdUnit)`)` The resulting ad units for the requested account. |\n| `nextPageToken` | `string` If not empty, indicates that there may be more ad units for the request; this value should be passed in a new `ListAdUnitsRequest`. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admob.monetization`\n- `\n https://www.googleapis.com/auth/admob.readonly`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
