列出指定 AdMob 帳戶下的應用程式。
HTTP 要求
GET https://admob.googleapis.com/v1/{parent=accounts/*}/apps
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
parent |
必要欄位。要列出應用程式的帳戶資源名稱。範例:accounts/pub-9876543210987654 |
查詢參數
參數 | |
---|---|
pageSize |
可傳回的應用程式數量上限。如未指定或未指定 0,最多將傳回 10,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,則會是 App Store ID。例如「105169111」。 請注意,設定應用程式商店 ID 視為無法復原的動作。應用程式連結後即無法取消連結。 |
displayName |
僅供輸出。應用程式在應用程式商店中顯示的顯示名稱。此為僅供輸出欄位,如果在商店中找不到應用程式,則會留空。 |
AppApprovalState
行動應用程式的應用程式核准狀態。
列舉 | |
---|---|
APP_APPROVAL_STATE_UNSPECIFIED |
未設定欄位的預設值。請勿使用。 |
ACTION_REQUIRED |
應用程式需要使用者採取額外動作來獲得核准。詳情請參閱 https://support.google.com/admob/answer/10564477,以及後續步驟。 |
IN_REVIEW |
應用程式尚待審查。 |
APPROVED |
應用程式已通過核准,可以放送廣告。 |