列出指定 AdMob 帐号下的应用。
HTTP 请求
GET https://admob.googleapis.com/v1/{parent=accounts/*}/apps
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
parent |
必需。要为其列出应用的帐号的资源名称。示例:accounts/pub-9876543210987654 |
查询参数
参数 | |
---|---|
pageSize |
要返回的应用数量上限。如果未指定或值为 0,则最多返回 10,000 个应用。最大值为 20,000;大于 20,000 的值将被强制转换为 20,000。 |
pageToken |
最后一个 |
请求正文
请求正文必须为空。
响应正文
对应用列表请求的响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"apps": [
{
object ( |
字段 | |
---|---|
apps[] |
为所请求帐号生成的应用。 |
nextPageToken |
如果不为空,表示可能有更多应用可处理相应请求;此值应在新的 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/admob.readonly
有关详情,请参阅 OAuth 2.0 概览。
应用
描述面向特定平台(例如 Android 或 iOS)的 AdMob 应用。
JSON 表示法 |
---|
{ "name": string, "appId": string, "platform": string, "manualAppInfo": { object ( |
字段 | |
---|---|
name |
此应用的资源名称。格式为 accounts/{publisherId}/apps/{app_id_fragment} 示例:accounts/pub-9876543210987654/apps/0123456789 |
appId |
应用的外部可见 ID,可用于与 AdMob SDK 集成。这是一个只读属性。示例:ca-app-pub-9876543210987654~0123456789 |
platform |
描述应用的平台。仅限“IOS”和“ANDROID”。 |
manualAppInfo |
未关联到任何应用商店的应用的信息。 应用关联后,仍可检索这些信息。如果在创建应用时未提供应用名称,系统将使用占位符名称。 |
linkedAppInfo |
不可变。已关联到应用商店的应用的信息。 当且仅当应用已关联至应用商店时,此字段才会显示。 |
appApprovalState |
仅供输出。应用的审批状态。该字段为只读字段。 |
ManualAppInfo
为未关联到应用商店(例如:Google Play、App Store)的手动应用提供的信息。
JSON 表示法 |
---|
{ "displayName": string } |
字段 | |
---|---|
displayName |
AdMob 界面中显示的应用的显示名称,由用户提供。允许的长度上限为 80 个字符。 |
LinkedAppInfo
应用商店中的信息(如果应用已关联到应用商店)。
JSON 表示法 |
---|
{ "appStoreId": string, "displayName": string } |
字段 | |
---|---|
appStoreId |
应用的应用商店 ID;当且仅当应用已关联到应用商店时,此字段才会显示。 如果应用已添加到 Google Play 商店中,则它是应用的 ID。例如:“com.example.myapp”。请访问 https://developer.android.com/studio/build/application-id。 如果应用已添加到 Apple App Store,则会是应用商店 ID。例如“105169111”。 请注意,设置应用商店 ID 被视为不可逆转的操作。应用一旦关联,便无法再解除关联。 |
displayName |
仅供输出。应用在应用商店中显示的名称。此字段是仅输出字段,如果在商店中找不到该应用,则可能为空。 |
AppApprovalState
移动应用的应用审批状态。
枚举 | |
---|---|
APP_APPROVAL_STATE_UNSPECIFIED |
未设置的字段的默认值。请勿使用。 |
ACTION_REQUIRED |
应用需要用户执行额外的操作才能获得批准。如需了解详情和后续步骤,请参阅 https://support.google.com/admob/answer/10564477。 |
IN_REVIEW |
此应用正在等待审核。 |
APPROVED |
应用已获批准,可以投放广告。 |