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

แอป

อธิบายแอป 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_pacity} เช่น 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

ข้อมูลที่ให้ไว้สำหรับแอปที่ใช้งานด้วยตนเองซึ่งไม่ได้ลิงก์กับ Application 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 ช่องนี้เป็นช่องสำหรับเอาต์พุตเท่านั้น และอาจว่างเปล่าหากไม่พบแอปใน Store

AppApprovalState

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

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