Method: accounts.apps.list

列出指定 AdMob 帐号下的应用。

HTTP 请求

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

网址采用 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.readonly

有关详情，请参阅 OAuth 2.0 概览。

应用

描述面向特定平台（例如 Android 或 iOS）的 AdMob 应用。

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

应用的外部可见 ID，可用于与 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

应用的应用商店 ID；当且仅当应用已关联到应用商店时，此字段才会显示。

如果应用已添加到 Google Play 商店中，则它是应用的 ID。例如：“com.example.myapp”。请访问 https://developer.android.com/studio/build/application-id。

如果应用已添加到 Apple App Store，则会是应用商店 ID。例如“105169111”。

请注意，设置应用商店 ID 被视为不可逆转的操作。应用一旦关联，便无法再解除关联。
displayName

string

仅供输出。应用在应用商店中显示的名称。此字段是仅输出字段，如果在商店中找不到该应用，则可能为空。

AppApprovalState

移动应用的应用审批状态。

枚举
APP_APPROVAL_STATE_UNSPECIFIED 未设置的字段的默认值。请勿使用。
ACTION_REQUIRED 应用需要用户执行额外的操作才能获得批准。如需了解详情和后续步骤，请参阅 https://support.google.com/admob/answer/10564477。
IN_REVIEW 此应用正在等待审核。
APPROVED 应用已获批准，可以投放广告。