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。
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 UI 中顯示的應用程式名稱 (由使用者提供)。長度上限為 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 應用程式已通過核准，可以放送廣告。