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 に追加されている場合は、アプリストア ID になります。例: 「105169111」

アプリストア ID の設定は、元に戻せない操作と見なされます。アプリをいったんリンクすると、解除できなくなります。
displayName

string

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

AppApprovalState

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

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