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 就是该应用的应用 ID。例如：“com.example.myapp”。请访问 https://developer.android.com/studio/build/application-id。

如果应用添加到 Apple App Store，它就是 App Store ID。例如“105169111”。

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

string

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

AppApprovalState

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

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