- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- แอป
- ManualAppInfo
- LinkedAppInfo
- AppApprovalState
- ตัวอย่าง
- ลองใช้งาน
แสดงรายชื่อแอปภายใต้บัญชี AdMob ที่ระบุ
คำขอ HTTP
GET https://admob.googleapis.com/v1/{parent=accounts/*}/apps
URL ใช้ไวยากรณ์การแปลง 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
แอป
อธิบายแอป AdMob สำหรับแพลตฟอร์มที่เฉพาะเจาะจง (เช่น Android หรือ iOS)
การแสดง JSON |
---|
{ "name": string, "appId": string, "platform": string, "manualAppInfo": { object ( |
ช่อง | |
---|---|
name |
ชื่อทรัพยากรของแอปนี้ รูปแบบคือ accounts/{publisherId}/apps/{app_id_fragment} ตัวอย่าง: accounts/pub-9876543210987654/apps/0123456789 |
appId |
รหัสแอปที่มองเห็นได้จากภายนอกซึ่งสามารถใช้เพื่อผสานรวมกับ AdMob SDK คุณสมบัตินี้เป็นแบบอ่านอย่างเดียว ตัวอย่างเช่น ca-app-pub-9876543210987654~0123456789 |
platform |
อธิบายแพลตฟอร์มของแอป จำกัดไว้ที่ "IOS" และ "Android" |
manualAppInfo |
ข้อมูลสำหรับแอปที่ไม่ได้ลิงก์กับ App Store ใดๆ หลังจากที่ลิงก์แอปแล้ว ข้อมูลนี้จะยังคงเข้าถึงได้ หากไม่ได้ระบุชื่อแอปไว้ตอนสร้าง ระบบจะใช้ชื่อตัวยึดตำแหน่ง |
linkedAppInfo |
เปลี่ยนแปลงไม่ได้ ข้อมูลสำหรับแอปที่ลิงก์กับ App Store ช่องนี้จะมีอยู่ก็ต่อเมื่อแอปลิงก์กับ App Store เท่านั้น |
appApprovalState |
เอาต์พุตเท่านั้น สถานะการอนุมัติสำหรับแอป ช่องนี้เป็นแบบอ่านอย่างเดียว |
ManualAppInfo
ข้อมูลที่ระบุสำหรับแอปด้วยตนเองซึ่งไม่ได้ลิงก์กับ App Store (เช่น Google Play, App Store)
การแสดง JSON |
---|
{ "displayName": string } |
ช่อง | |
---|---|
displayName |
ชื่อที่แสดงของแอปตามที่แสดงใน UI ของ AdMob ซึ่งผู้ใช้เป็นผู้ระบุ ความยาวสูงสุดที่อนุญาตคือ 80 อักขระ |
LinkedAppInfo
ข้อมูลจาก App Store ในกรณีที่แอปลิงก์กับ App Store
การแสดง JSON |
---|
{ "appStoreId": string, "displayName": string } |
ช่อง | |
---|---|
appStoreId |
รหัส 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 |
เอาต์พุตเท่านั้น แสดงชื่อแอปตามที่ปรากฏใน App Store ช่องนี้เป็นช่องเอาต์พุตเท่านั้น และอาจว่างเปล่าหากไม่พบแอปใน Store |
AppApprovalState
สถานะการอนุมัติของแอปสำหรับแอปบนอุปกรณ์เคลื่อนที่
Enum | |
---|---|
APP_APPROVAL_STATE_UNSPECIFIED |
ค่าเริ่มต้นสำหรับช่องที่ไม่มีการตั้งค่า โปรดอย่าใช้ |
ACTION_REQUIRED |
ผู้ใช้ต้องดำเนินการเพิ่มเติมเพื่อขอรับการอนุมัติแอป โปรดไปที่ https://support.google.com/admob/answer/10564477 เพื่อดูรายละเอียดและขั้นตอนถัดไป |
IN_REVIEW |
แอปกำลังรอการตรวจสอบ |
APPROVED |
แอปได้รับอนุมัติและแสดงโฆษณาได้ |