- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ลองใช้งาน
แสดงรายการโฆษณาของกลุ่มโฆษณา
คำขอ HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/adGroupAds
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
advertiserId |
ต้องระบุ รหัสของผู้ลงโฆษณาที่มีกลุ่มโฆษณา |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
pageSize |
ไม่บังคับ ขนาดหน้าที่ขอ ต้องอยู่ระหว่าง |
pageToken |
ไม่บังคับ โทเค็นที่ระบุหน้าผลลัพธ์ที่เซิร์ฟเวอร์ควรจะแสดงผล โดยปกติแล้วจะเป็นค่าของ |
orderBy |
ไม่บังคับ ช่องที่จะใช้จัดเรียงรายการ ค่าที่ยอมรับมีดังนี้
ลำดับการจัดเรียงเริ่มต้นจะเป็นจากน้อยไปมาก หากต้องการระบุลำดับจากมากไปน้อยสำหรับช่อง ควรเพิ่มส่วนต่อท้าย "desc" ลงในชื่อช่อง ตัวอย่าง: |
filter |
ไม่บังคับ อนุญาตให้กรองตามช่องโฆษณาของกลุ่มโฆษณาที่กำหนดเอง ไวยากรณ์ที่รองรับ:
ช่องที่รองรับ
ตัวอย่าง
ช่องนี้ควรมีความยาวไม่เกิน 500 อักขระ โปรดดูข้อมูลเพิ่มเติมในคำแนะนำเกี่ยวกับตัวกรองคำขอ |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"adGroupAds": [
{
object ( |
ช่อง | |
---|---|
adGroupAds[] |
รายการโฆษณาของกลุ่มโฆษณา รายการนี้จะไม่แสดงหากว่างเปล่า |
nextPageToken |
โทเค็นสำหรับเรียกผลการค้นหาหน้าถัดไป ส่งค่านี้ในช่อง |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/display-video
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0