ดิสเพลย์และ Video 360 API v2 จะหยุดให้บริการในวันที่
3 กันยายน 2024 โปรด
ย้ายข้อมูลไปยังเวอร์ชัน 3 ก่อนวันที่ดังกล่าวเพื่อไม่ให้บริการหยุดชะงัก
ส่งความคิดเห็น
Method: advertisers.youtubeAdGroupAds.list
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
เลิกใช้งาน Display & Video 360 API v2 แล้วและจะหยุดให้บริการในวันที่ 3 กันยายน 2024 โปรดดูคำแนะนำในการย้ายข้อมูล เพื่อช่วยในการย้ายข้อมูลไปยังเวอร์ชัน 3
แสดงโฆษณาของกลุ่มโฆษณา YouTube
คำขอ HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/youtubeAdGroupAds
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์
advertiserId
string (int64 format)
ต้องระบุ รหัสของผู้ลงโฆษณาที่มีกลุ่มโฆษณา
พารามิเตอร์การค้นหา
พารามิเตอร์
pageSize
integer
ขนาดหน้าที่ขอ ต้องอยู่ระหว่าง 1
ถึง 100
หากไม่ระบุ จะใช้ค่าเริ่มต้นเป็น 100
แสดงผลรหัสข้อผิดพลาด INVALID_ARGUMENT
หากระบุค่าไม่ถูกต้อง
pageToken
string
โทเค็นที่ระบุหน้าผลลัพธ์ที่เซิร์ฟเวอร์ควรแสดงผล โดยทั่วไป ค่านี้คือค่าของ nextPageToken
ที่แสดงผลจากการเรียกไปยังเมธอด youtubeAdGroupAds.list
ก่อนหน้านี้ หากไม่ระบุ ระบบจะแสดงผลการค้นหาหน้าแรก
orderBy
string
ช่องที่จะใช้จัดเรียงรายการ ค่าที่ยอมรับได้มีดังนี้
displayName
(ค่าเริ่มต้น)
entityStatus
ลำดับการจัดเรียงเริ่มต้นจะเรียงจากน้อยไปมาก หากต้องการระบุลำดับจากมากไปน้อยของช่อง ควรเพิ่มส่วนต่อท้าย "desc" ลงในชื่อช่อง ตัวอย่าง: displayName desc
filter
string
อนุญาตให้กรองตามช่องโฆษณาของกลุ่มโฆษณา YouTube ที่กำหนดเอง
ไวยากรณ์ที่รองรับ:
นิพจน์ตัวกรองประกอบด้วยข้อจำกัดอย่างน้อย 1 ข้อ
AND
และ OR
รวมกันได้ ลำดับของข้อจำกัดจะใช้ AND
โดยปริยาย
ข้อจำกัดอยู่ในรูปแบบ {field} {operator} {value}
ทุกช่องต้องใช้โอเปอเรเตอร์ EQUALS (=)
ช่องที่รองรับมีดังนี้
adGroupId
displayName
entityStatus
adGroupAdId
ตัวอย่าง
โฆษณาของกลุ่มโฆษณาทั้งหมดภายในกลุ่มโฆษณา: adGroupId="1234"
โฆษณาของกลุ่มโฆษณาทั้งหมดในกลุ่มโฆษณาที่มีสถานะเอนทิตี ENTITY_STATUS_ACTIVE
หรือ ENTITY_STATUS_PAUSED
: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED") AND
adGroupId="12345"
ฟิลด์นี้ควรมีความยาวไม่เกิน 500 อักขระ
โปรดดูข้อมูลเพิ่มเติมในคู่มือตัวกรอง LIST
คำขอ
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON
{
"youtubeAdGroupAds" : [
{
object (YoutubeAdGroupAd
)
}
] ,
"nextPageToken" : string
}
ช่อง
youtubeAdGroupAds[]
object (YoutubeAdGroupAd
)
รายการของโฆษณาของกลุ่มโฆษณา
รายการนี้จะสูญหายไปหากไม่มีข้อมูล
nextPageToken
string
โทเค็นสำหรับเรียกหน้าถัดไปของผลการค้นหา ส่งค่านี้ในฟิลด์ pageToken
ในการเรียกเมธอด youtubeAdGroupAds.list
ที่ตามมาเพื่อดึงผลการค้นหาหน้าถัดไป
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/display-video
โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0
ส่งความคิดเห็น
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-06-11 UTC
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"ไม่มีข้อมูลที่ฉันต้องการ"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"ล้าสมัย"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ปัญหาเกี่ยวกับการแปล"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"อื่นๆ"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"เข้าใจง่าย"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"แก้ปัญหาของฉันได้"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"อื่นๆ"
}]
หากต้องการบอกให้เราทราบเพิ่มเติม