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 にすると、最大で 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 に追加されている場合は App Store ID になります。例: 「105169111」

アプリストア ID を設定すると、元に戻すことはできません。一度リンクしたアプリのリンクは解除できません。
displayName

string

出力のみ。アプリストアに表示されるアプリの表示名。これは出力専用のフィールドです。アプリがストアで見つからない場合は空になることがあります。

AppApprovalState

モバイルアプリのアプリの承認ステータスです。

列挙型
APP_APPROVAL_STATE_UNSPECIFIED 未設定のフィールドのデフォルト値。使用しないでください。
ACTION_REQUIRED アプリの承認には、追加のユーザー操作が必要です。詳細と次のステップについては、https://support.google.com/admob/answer/10564477 をご覧ください。
IN_REVIEW このアプリは審査待ちです。
APPROVED アプリは承認され、広告を配信できます。