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 Overview。

应用

描述特定平台（例如 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

应用的 App Store ID；仅当应用与应用商店相关联时才存在。

如果应用已添加到 Google Play 商店，则为该应用的 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 应用已获得批准，可以投放广告。