Method: accounts.apps.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הצגת רשימה של האפליקציות בחשבון AdMob שצוין.
בקשת HTTP
GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/apps
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים |
parent |
string
חובה. שם המשאב של החשבון שעבורו רוצים להציג את רשימת האפליקציות. לדוגמה: accounts/pub-9876543210987654
|
פרמטרים של שאילתה
פרמטרים |
pageSize |
integer
המספר המקסימלי של אפליקציות שצריך להחזיר. אם לא צוין 0, יוחזרו 10,000 אפליקציות לכל היותר. הערך המקסימלי הוא 20,000; ערכים מעל 20,000 יקובצו ל-20,000.
|
pageToken |
string
הערך שהוחזר על ידי ListAppsResponse האחרון; מציין שמדובר בהמשך לקריאה קודמת של apps.list , ושהמערכת צריכה להחזיר את דף הנתונים הבא.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תשובה לבקשה של רשימת האפליקציות.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
{
"apps": [
{
object (App )
}
],
"nextPageToken": string
} |
שדות |
apps[] |
object (App )
האפליקציות שנוצרו עבור החשבון המבוקש.
|
nextPageToken |
string
אם השדה לא ריק, המשמעות היא שיכול להיות שיש אפליקציות נוספות לבקשה. צריך להעביר את הערך הזה בListAppsRequest חדש.
|
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של 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\u003eLists all the apps associated with a specific AdMob account using an HTTP GET request.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to retrieve large numbers of apps with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of apps and a token for retrieving the next page, if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific OAuth scopes for authorization: \u003ccode\u003ehttps://www.googleapis.com/auth/admob.monetization\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/admob.readonly\u003c/code\u003e.\u003c/p\u003e\n"]]],["This API call lists apps under a specified AdMob account. It uses a `GET` request to `https://admob.googleapis.com/v1beta/{parent=accounts/*}/apps`. The `parent` path parameter (e.g., `accounts/pub-9876543210987654`) is required. Optional query parameters `pageSize` (max 20,000) and `pageToken` are used for pagination. The request body is empty. The response includes a list of apps and an optional `nextPageToken` for subsequent requests and requires specific authorization scopes.\n"],null,["# Method: accounts.apps.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.ListAppsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nList the apps under the specified AdMob account.\n\n### HTTP request\n\n`GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/apps`\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 apps for. Example: accounts/pub-9876543210987654 |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of apps to return. If unspecified or 0, at most 10,000 apps 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 `ListAppsResponse`; indicates that this is a continuation of a prior `apps.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 apps list request.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------|\n| ``` { \"apps\": [ { object (/admob/api/reference/rest/v1beta/accounts.apps#App) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| `apps[]` | `object (`[App](/admob/api/reference/rest/v1beta/accounts.apps#App)`)` The resulting apps for the requested account. |\n| `nextPageToken` | `string` If not empty, indicates that there may be more apps for the request; this value should be passed in a new `ListAppsRequest`. |\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)."]]