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 個值將強制轉換為 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，則會是應用程式商店 ID。例如「105169111」。

請注意，設定應用程式商店 ID 是無法復原的動作。應用程式連結後即無法取消連結。
displayName

string

僅供輸出。應用程式在應用程式商店中顯示的顯示名稱。這是一個僅限輸出的欄位，如果在商店中找不到應用程式，它會是空白的。

AppApprovalState

行動應用程式的應用程式核准狀態。

列舉
APP_APPROVAL_STATE_UNSPECIFIED 未設定欄位的預設值。請勿使用。
ACTION_REQUIRED 應用程式需要使用者採取其他動作並獲得核准。詳情請參閱 https://support.google.com/admob/answer/10564477。
IN_REVIEW 應用程式待審中。
APPROVED 應用程式已通過核准，可以放送廣告。