Method: accounts.mediationGroups.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eLists mediation groups associated with a specific AdMob account using the \u003ccode\u003eaccounts.mediationGroups.list\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of results based on criteria like ad source IDs, ad unit IDs, app IDs, display name, format, platform, state, and targeted region codes.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes like \u003ccode\u003eadmob.monetization\u003c/code\u003e or \u003ccode\u003eadmob.readonly\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eReturns a paginated list of mediation groups with details like their display name, format, platform, and state, along with a token for retrieving subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eProvides access to the mediation group's configuration information which can be used for managing and optimizing ad revenue.\u003c/p\u003e\n"]]],["This outlines how to list mediation groups within an AdMob account using a `GET` request. The request URL structure includes a required `parent` path parameter specifying the account. Optional query parameters are available: `pageSize` controls the number of results (max 20,000), `pageToken` for pagination, and `filter` to narrow results by criteria like `DISPLAY_NAME`, `PLATFORM`, or `AD_SOURCE_IDS`. The request body is empty. A successful response contains an array of `mediationGroups` and a `nextPageToken` for pagination. Authorization is required.\n"],null,["# Method: accounts.mediationGroups.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.ListMediationGroupsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nList mediation groups under the specified AdMob account.\n\n\u003cbr /\u003e\n\n| This method has limited access. If you see a 403 permission denied error, please reach out to your account manager for access.\n\n\u003cbr /\u003e\n\n### HTTP request\n\n`GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/mediationGroups`\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 mediation groups for. Example: accounts/pub-9876543210987654 |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of mediation groups to return. If unspecified or 0, at most 10,000 mediation groups 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 `ListMediationGroupsResponse`; indicates that this is a continuation of a prior `mediationGroups.list` call, and that the system should return the next page of data. |\n| `filter` | `string` The filter string that uses [EBNF grammar syntax](https://google.aip.dev/assets/misc/ebnf-filtering.txt). Possible fields to filter by are: - \"AD_SOURCE_IDS\" - \"AD_UNIT_IDS\" - \"APP_IDS\" - \"DISPLAY_NAME\" - \"FORMAT\" - \"MEDIATION_GROUP_ID\" - \"PLATFORM\" - \"STATE\" - \"TARGETED_REGION_CODES\" Possible filter functions are: - `IN`: Used to filter fields that represent a singleton including \"MEDIATION_GROUP_ID\", \"DISPLAY_NAME\", \"STATE\", \"PLATFORM\", and \"FORMAT\". - `CONTAINS_ANY`: Used to filter fields that represent a collection including \"AD_SOURCE_IDS\", \"AD_UNIT_IDS\", \"APP_IDS\", and \"TARGETED_REGION_CODES\". The filter functions can be added together using `AND`. `OR` functionality is not supported. Example: filter: IN(DISPLAY_NAME, \"Test Group 1\", \"Test Group 2\") AND IN(PLATFORM, \"ANDROID\") AND CONTAINS_ANY(AD_SOURCE_IDS, \"5450213213286189855\") |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the mediation groups list request.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"mediationGroups\": [ { object (/admob/api/reference/rest/v1beta/accounts.mediationGroups#MediationGroup) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `mediationGroups[]` | `object (`[MediationGroup](/admob/api/reference/rest/v1beta/accounts.mediationGroups#MediationGroup)`)` The resulting mediation groups for the requested account. |\n| `nextPageToken` | `string` If not empty, indicates that there may be more mediation groups for the request; this value should be passed in a new `ListMediationGroupsRequest`. |\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)."]]
