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 Overview。

應用程式

說明特定平台 (例如 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 應用程式已獲准放送廣告。