Method: accounts.apps.list

برنامه‌ها را در حساب AdMob مشخص شده فهرست کنید.

درخواست HTTP

GET https://admob.googleapis.com/v1/{parent=accounts/*}/apps

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
parent

string

ضروری. نام منبع حساب برای فهرست کردن برنامه‌ها. مثال: accounts/pub-9876543210987654

پارامترهای پرس و جو

مولفه های
pageSize

integer

حداکثر تعداد برنامه برای بازگشت. اگر نامشخص یا 0 باشد، حداکثر 10000 برنامه برگردانده می شود. حداکثر مقدار 20000 است. مقادیر بالای 20000 به 20000 اجباری می شود.

pageToken

string

مقدار بازگشتی توسط آخرین ListAppsResponse . نشان می دهد که این ادامه تماس قبلی apps.list است و سیستم باید صفحه بعدی داده ها را برگرداند.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ به درخواست لیست برنامه ها.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "apps": [
    {
      object (App)
    }
  ],
  "nextPageToken": string
}
زمینه های
apps[]

object ( App )

برنامه های به دست آمده برای حساب درخواستی.

nextPageToken

string

اگر خالی نباشد، نشان می دهد که ممکن است برنامه های بیشتری برای درخواست وجود داشته باشد. این مقدار باید در یک ListAppsRequest جدید ارسال شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/admob.readonly

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

برنامه

یک برنامه AdMob را برای یک پلتفرم خاص (به عنوان مثال: Android یا iOS) توصیف می کند.

نمایندگی JSON
{
  "name": string,
  "appId": string,
  "platform": string,
  "manualAppInfo": {
    object (ManualAppInfo)
  },
  "linkedAppInfo": {
    object (LinkedAppInfo)
  },
  "appApprovalState": enum (AppApprovalState)
}
زمینه های
name

string

نام منبع برای این برنامه قالب: accounts/{publisherId}/apps/{app_id_fragment} مثال: accounts/pub-9876543210987654/apps/0123456789

appId

string

شناسه قابل مشاهده خارجی برنامه که می تواند برای ادغام با AdMob SDK استفاده شود. این یک ویژگی فقط خواندنی است. مثال: ca-app-pub-9876543210987654~0123456789

platform

string

پلت فرم برنامه را توضیح می دهد. محدود به "IOS" و "ANDROID".

manualAppInfo

object ( ManualAppInfo )

اطلاعات برنامه‌ای که به هیچ فروشگاه اپلیکیشنی مرتبط نیست.

پس از پیوند یک برنامه، این اطلاعات همچنان قابل بازیابی است. اگر در هنگام ایجاد، نامی برای برنامه ارائه نشده باشد، از نام مکان‌نما استفاده می‌شود.

linkedAppInfo

object ( LinkedAppInfo )

تغییرناپذیر. اطلاعات برنامه‌ای که به فروشگاه برنامه پیوند داده شده است.

این فیلد اگر و فقط در صورتی وجود دارد که برنامه به یک فروشگاه برنامه مرتبط باشد.

appApprovalState

enum ( AppApprovalState )

فقط خروجی وضعیت تأیید برنامه فیلد فقط خواندنی است.

ManualAppInfo

اطلاعات ارائه شده برای برنامه های دستی که به فروشگاه برنامه مرتبط نیستند (مثال: Google Play، App Store).

نمایندگی JSON
{
  "displayName": string
}
زمینه های
displayName

string

نام نمایشی برنامه همانطور که در رابط کاربری AdMob نشان داده شده است که توسط کاربر ارائه شده است. حداکثر طول مجاز 80 کاراکتر است.

LinkedAppInfo

اگر برنامه به یک فروشگاه برنامه پیوند داده شده باشد، اطلاعات از فروشگاه برنامه.

نمایندگی JSON
{
  "appStoreId": string,
  "displayName": string
}
زمینه های
appStoreId

string

شناسه فروشگاه برنامه برنامه؛ اگر و فقط در صورتی که برنامه به یک فروشگاه برنامه مرتبط باشد، ارائه شود.

اگر برنامه به فروشگاه Google Play اضافه شود، شناسه برنامه برنامه خواهد بود. به عنوان مثال: "com.example.myapp". به https://developer.android.com/studio/build/application-id مراجعه کنید.

اگر برنامه به اپ استور اپل اضافه شود، شناسه فروشگاه اپلیکیشن خواهد بود. به عنوان مثال "105169111".

توجه داشته باشید که تنظیم شناسه فروشگاه اپلیکیشن یک اقدام غیرقابل برگشت در نظر گرفته می شود. هنگامی که یک برنامه پیوند داده شد، نمی توان آن را لغو پیوند کرد.

displayName

string

فقط خروجی نمایش نام برنامه همانطور که در فروشگاه برنامه ظاهر می شود. این یک فیلد فقط خروجی است و اگر برنامه در فروشگاه پیدا نشود ممکن است خالی باشد.

AppApprovalState

تأییدیه برنامه برای یک برنامه تلفن همراه ذکر شده است.

Enums
APP_APPROVAL_STATE_UNSPECIFIED مقدار پیش فرض برای یک فیلد تنظیم نشده. استفاده نکن.
ACTION_REQUIRED برنامه برای تأیید نیاز به اقدام کاربر اضافی دارد. لطفاً برای جزئیات و مراحل بعدی به https://support.google.com/admob/answer/10564477 مراجعه کنید.
IN_REVIEW برنامه در انتظار بررسی است.
APPROVED این برنامه تأیید شده است و می تواند تبلیغات را ارائه دهد.