Method: accounts.adUnits.list
واحدهای تبلیغاتی را در حساب AdMob مشخص شده فهرست کنید.
درخواست HTTP
GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adUnits
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
parent | string مورد نیاز. نام منبع حساب برای فهرست کردن واحدهای تبلیغاتی. مثال: accounts/pub-9876543210987654 |
پارامترهای پرس و جو
پارامترها |
---|
pageSize | integer حداکثر تعداد واحدهای تبلیغاتی برای بازگشت. اگر نامشخص یا 0 باشد، حداکثر 10000 واحد تبلیغاتی برگردانده می شود. حداکثر مقدار 20000 است. مقادیر بالای 20000 به 20000 اجباری می شود. |
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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-06 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-06 بهوقت ساعت هماهنگ جهانی."],[[["This page explains how to list ad units associated with a specific AdMob account using the `adUnits.list` method."],["The method requires the `parent` path parameter to specify the AdMob account and accepts optional `pageSize` and `pageToken` query parameters for pagination."],["Successful responses provide a list of `AdUnits` and a `nextPageToken` for retrieving additional pages if available."],["Authorization is required using either `https://www.googleapis.com/auth/admob.monetization` or `https://www.googleapis.com/auth/admob.readonly` OAuth scopes."]]],["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"]]