列出指定 AdMob 帳戶下的應用程式。
HTTP 要求
GET https://admob.googleapis.com/v1/{parent=accounts/*}/apps
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
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 UI 中顯示的應用程式顯示名稱,由使用者提供。長度上限為 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,則會是應用程式商店 ID。例如「105169111」。 請注意,設定應用程式商店 ID 是無法復原的動作。應用程式連結後即無法取消連結。 |
displayName |
僅供輸出。應用程式在應用程式商店中顯示的顯示名稱。這是一個僅限輸出的欄位,如果在商店中找不到應用程式,它會是空白的。 |
AppApprovalState
行動應用程式的應用程式核准狀態。
列舉 | |
---|---|
APP_APPROVAL_STATE_UNSPECIFIED |
未設定欄位的預設值。請勿使用。 |
ACTION_REQUIRED |
應用程式需要使用者採取其他動作並獲得核准。詳情請參閱 https://support.google.com/admob/answer/10564477。 |
IN_REVIEW |
應用程式待審中。 |
APPROVED |
應用程式已通過核准,可以放送廣告。 |