Method: advertisers.list
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
แสดงรายการผู้ลงโฆษณาที่ผู้ใช้ปัจจุบันเข้าถึงได้
ลำดับจะกำหนดโดยพารามิเตอร์ orderBy
ต้องระบุ partnerId
รายการเดียว ไม่รองรับข้อมูลข้ามพาร์ทเนอร์
คำขอ HTTP
GET https://displayvideo.googleapis.com/v2/advertisers
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์การค้นหา
พารามิเตอร์ |
partnerId |
string (int64 format)
ต้องระบุ รหัสของพาร์ทเนอร์ที่ผู้ลงโฆษณาที่ดึงข้อมูลทั้งหมดควรเป็นสมาชิก ระบบจะรองรับผู้ลงโฆษณารายชื่อสำหรับพาร์ทเนอร์ทีละ 1 รายเท่านั้น
|
pageSize |
integer
ขนาดหน้าที่ขอ ต้องอยู่ระหว่าง 1 ถึง 200 หากไม่ระบุ จะใช้ค่าเริ่มต้นเป็น 100
|
pageToken |
string
โทเค็นที่ระบุหน้าผลลัพธ์ที่เซิร์ฟเวอร์ควรแสดงผล โดยทั่วไป ค่านี้คือค่าของ nextPageToken ที่แสดงผลจากการเรียกไปยังเมธอด advertisers.list ก่อนหน้านี้ หากไม่ระบุ ระบบจะแสดงผลการค้นหาหน้าแรก
|
orderBy |
string
ช่องที่จะใช้จัดเรียงรายการ ค่าที่ยอมรับได้มีดังนี้
displayName (ค่าเริ่มต้น)
entityStatus
updateTime
ลำดับการจัดเรียงเริ่มต้นจะเรียงจากน้อยไปมาก หากต้องการระบุลำดับจากมากไปน้อยของช่อง ควรเพิ่มส่วนต่อท้าย "desc" ลงในชื่อช่อง เช่น displayName desc
|
filter |
string
อนุญาตให้กรองตามช่องของผู้ลงโฆษณา ไวยากรณ์ที่รองรับ:
- นิพจน์ตัวกรองประกอบด้วยข้อจำกัดอย่างน้อย 1 ข้อ
- สามารถรวมข้อจำกัดได้โดยโอเปอเรเตอร์เชิงตรรกะ
AND หรือ OR
- ข้อจำกัดอยู่ในรูปแบบ
{field} {operator} {value}
- ฟิลด์
updateTime ต้องใช้โอเปอเรเตอร์ GREATER THAN OR EQUAL TO (>=) หรือ LESS THAN OR EQUAL TO (<=)
- ช่องอื่นๆ ทั้งหมดต้องใช้โอเปอเรเตอร์
EQUALS (=)
ช่องที่รองรับมีดังนี้
advertiserId
displayName
entityStatus
updateTime (ป้อนข้อมูลในรูปแบบ ISO 8601 หรือ YYYY-MM-DDTHH:MM:SSZ )
ตัวอย่าง
- ผู้ลงโฆษณาที่ใช้งานอยู่ทั้งหมดภายใต้พาร์ทเนอร์ 1 ราย:
entityStatus="ENTITY_STATUS_ACTIVE"
- ผู้ลงโฆษณาทั้งหมดที่มีเวลาอัปเดตน้อยกว่าหรือเท่ากับ 2020-11-04T18:54:47Z (รูปแบบ ISO 8601):
updateTime<="2020-11-04T18:54:47Z"
- ผู้ลงโฆษณาทั้งหมดที่มีเวลาอัปเดตมากกว่าหรือเท่ากับ 2020-11-04T18:54:47Z (รูปแบบ ISO 8601):
updateTime>="2020-11-04T18:54:47Z"
ฟิลด์นี้ควรมีความยาวไม่เกิน 500 อักขระ โปรดดูข้อมูลเพิ่มเติมในคู่มือตัวกรอง LIST คำขอ
|
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
{
"advertisers": [
{
object (Advertiser )
}
],
"nextPageToken": string
} |
ช่อง |
advertisers[] |
object (Advertiser )
รายชื่อผู้ลงโฆษณา รายการนี้จะสูญหายไปหากไม่มีข้อมูล
|
nextPageToken |
string
โทเค็นสำหรับเรียกหน้าถัดไปของผลการค้นหา ส่งค่านี้ในฟิลด์ pageToken ในการเรียกเมธอด advertisers.list ที่ตามมาเพื่อดึงผลการค้นหาหน้าถัดไป
|
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/display-video
โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-02-16 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":"อื่นๆ"
}]