Method: accounts.apps.list

แสดงรายการแอปภายใต้บัญชี AdMob ที่ระบุ

คำขอ HTTP

GET https://admob.googleapis.com/v1/{parent=accounts/*}/apps

URL ใช้ไวยากรณ์การแปลงรหัส 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 Overview

แอป

อธิบายแอป AdMob สำหรับแพลตฟอร์มที่เฉพาะเจาะจง (เช่น Android หรือ iOS)

การแสดง 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

รหัสที่มองเห็นได้ภายนอกของแอปซึ่งใช้ผสานรวมกับ AdMob SDK ได้ พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว ตัวอย่าง: ca-app-pub-9876543210987654~0123456789
platform

string

อธิบายแพลตฟอร์มของแอป จำกัดเฉพาะ "IOS" และ "ANDROID"
manualAppInfo

object (ManualAppInfo)

ข้อมูลสำหรับแอปที่ไม่ได้ลิงก์กับ App Store ใดๆ

หลังจากลิงก์แอปแล้ว คุณจะยังดึงข้อมูลนี้ได้ หากไม่ได้ระบุชื่อแอปเมื่อสร้าง ระบบจะใช้ชื่อตัวยึดตำแหน่ง
linkedAppInfo

object (LinkedAppInfo)

เปลี่ยนแปลงไม่ได้ ข้อมูลสำหรับแอปที่ลิงก์กับ App Store

ฟิลด์นี้จะแสดงก็ต่อเมื่อแอปลิงก์กับ App Store เท่านั้น
appApprovalState

enum (AppApprovalState)

เอาต์พุตเท่านั้น สถานะการอนุมัติของแอป ช่องนี้เป็นแบบอ่านอย่างเดียว

ManualAppInfo

ข้อมูลที่ระบุสำหรับแอปที่สร้างขึ้นเองซึ่งไม่ได้ลิงก์กับ App Store (เช่น Google Play, App Store)

การแสดง JSON 
{
  "displayName": string
}
ช่อง
displayName

string

ชื่อที่แสดงของแอปตามที่แสดงใน UI ของ AdMob ซึ่งผู้ใช้เป็นผู้ระบุ ความยาวสูงสุดที่อนุญาตคือ 80 อักขระ

LinkedAppInfo

ข้อมูลจาก App Store หากแอปลิงก์กับ App Store

การแสดง JSON 
{
  "appStoreId": string,
  "displayName": string
}
ช่อง
appStoreId

string

รหัส App Store ของแอป จะแสดงก็ต่อเมื่อแอปลิงก์กับ App Store เท่านั้น

หากมีการเพิ่มแอปใน Google Play Store รหัสนี้จะเป็นรหัสแอปพลิเคชันของแอป เช่น "com.example.myapp" ดูที่ https://developer.android.com/studio/build/application-id

หากเพิ่มแอปไปยัง Apple App Store รหัสจะเป็นรหัส App Store เช่น "105169111"

โปรดทราบว่าการตั้งรหัส App Store ถือเป็นการดำเนินการที่ย้อนกลับไม่ได้ เมื่อลิงก์แอปแล้ว คุณจะยกเลิกการลิงก์ไม่ได้
displayName

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของแอปตามที่ปรากฏใน App Store นี่คือฟิลด์เอาต์พุตเท่านั้น และอาจว่างเปล่าหากไม่พบแอปในร้านค้า

AppApprovalState

สถานะการอนุมัติแอปสำหรับแอปบนอุปกรณ์เคลื่อนที่

Enum
APP_APPROVAL_STATE_UNSPECIFIED ค่าเริ่มต้นสำหรับช่องที่ไม่ได้ตั้งค่า โปรดอย่าใช้
ACTION_REQUIRED แอปต้องได้รับการอนุมัติโดยผู้ใช้ดำเนินการเพิ่มเติม โปรดดูรายละเอียดและขั้นตอนถัดไปที่ https://support.google.com/admob/answer/10564477
IN_REVIEW แอปอยู่ระหว่างรอการตรวจสอบ
APPROVED แอปได้รับอนุมัติและแสดงโฆษณาได้