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_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 ช่องนี้เป็นช่องเอาต์พุตเท่านั้น และอาจว่างเปล่าหากไม่พบแอปใน Store

AppApprovalState

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

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