- HTTP リクエスト
- パスパラメータ
- クエリ パラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- アプリ
- ManualAppInfo
- LinkedAppInfo(英語)
- AppApprovalState
- 例
- 試してみる
指定した AdMob アカウントのアプリを一覧表示します。
HTTP リクエスト
GET https://admob.googleapis.com/v1/{parent=accounts/*}/apps
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
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 に追加されている場合は App Store ID になります。例: 「105169111」 アプリストア ID を設定すると、元に戻すことはできません。一度リンクしたアプリのリンクは解除できません。 |
displayName |
出力のみ。アプリストアに表示されるアプリの表示名。これは出力専用のフィールドです。アプリがストアで見つからない場合は空になることがあります。 |
AppApprovalState
モバイルアプリのアプリの承認ステータスです。
列挙型 | |
---|---|
APP_APPROVAL_STATE_UNSPECIFIED |
未設定のフィールドのデフォルト値。使用しないでください。 |
ACTION_REQUIRED |
アプリの承認には、追加のユーザー操作が必要です。詳細と次のステップについては、https://support.google.com/admob/answer/10564477 をご覧ください。 |
IN_REVIEW |
このアプリは審査待ちです。 |
APPROVED |
アプリは承認され、広告を配信できます。 |