Method: advertisers.reachForecast.retrievePlannableUserLists

ดึงข้อมูลรายการผู้ใช้ของบุคคลที่หนึ่งและบุคคลที่สามที่พร้อมใช้งานสำหรับการคาดการณ์

คำขอ HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableUserLists

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
advertiserId

string (int64 format)

ต้องระบุ รหัสของผู้ลงโฆษณาที่จะดึงข้อมูลรายการผู้ใช้ที่วางแผนได้

พารามิเตอร์การค้นหา

พารามิเตอร์
pageSize

integer

ไม่บังคับ ขนาดหน้าเว็บที่ขอ ต้องอยู่ระหว่าง 1 ถึง 5000 หากไม่ระบุ ระบบจะใช้ค่าเริ่มต้นเป็น 5000
pageToken

string

ไม่บังคับ โทเค็นที่ระบุหน้าผลลัพธ์ที่เซิร์ฟเวอร์ควรแสดงผล โดยปกติแล้วจะเป็นค่าของ nextPageToken ที่แสดงผลจากการเรียกเมธอด reachForecast.retrievePlannableUserLists ครั้งก่อนหน้า หากไม่ระบุ ระบบจะแสดงผลหน้าแรกของผลลัพธ์
filter

string

ไม่บังคับ อนุญาตให้กรองตามพร็อพเพอร์ตี้รายการผู้ใช้ที่วางแผนได้

ไวยากรณ์ที่รองรับ

  • นิพจน์ตัวกรองประกอบด้วยข้อจำกัดอย่างน้อย 1 รายการ
  • คุณสามารถรวมข้อจำกัดโดยใช้ตัวดำเนินการทางตรรกะ AND หรือ OR
  • ข้อจำกัดมีรูปแบบเป็น {field} {operator} {value}
  • ฟิลด์ displayName ต้องใช้ตัวดำเนินการ HAS (:)
  • ฟิลด์อื่นๆ ทั้งหมดต้องใช้ตัวดำเนินการ EQUALS (=)

ฟิลด์ที่รองรับ

  • plannableStatus
  • displayName
  • userListType
  • name

ตัวอย่าง

  • รายการผู้ใช้ที่วางแผนได้ทั้งหมด: plannableStatus="PLANNABLE"
  • รายการผู้ใช้ที่วางแผนได้ซึ่งมีชื่อที่แสดง "Shopping": plannableStatus="PLANNABLE" AND displayName:"Shopping"
  • รายการผู้ใช้ของบุคคลที่หนึ่ง: userListType="FIRST_PARTY"

ความยาวของฟิลด์นี้ต้องไม่เกิน 500 อักขระ

ดูข้อมูลเพิ่มเติมได้ในคู่มือคำขอ ตัวกรอง LIST requests ของเรา

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบกลับสำหรับ reachForecast.retrievePlannableUserLists

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "plannableUserLists": [
    {
      object (PlannableUserList)
    }
  ],
  "nextPageToken": string
}
ช่อง
plannableUserLists[]

object (PlannableUserList)

แสดงผลเท่านั้น รายการผู้ใช้ที่วางแผนได้
nextPageToken

string

แสดงผลเท่านั้น โทเค็นสำหรับดึงข้อมูลหน้าถัดไปของผลลัพธ์

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/display-video

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview.

PlannableUserList

รายการผู้ใช้ที่วางแผนได้ซึ่งใช้สำหรับการคาดการณ์การเข้าถึง

การแสดง JSON 
{
  "displayName": string,
  "userListType": enum (UserListType),
  "name": string,
  "plannableStatus": enum (PlannableStatus)
}
ช่อง
displayName

string

แสดงผลเท่านั้น ชื่อที่แสดงของรายการผู้ใช้
userListType

enum (UserListType)

แสดงผลเท่านั้น ประเภทของรายการผู้ใช้
name

string

แสดงผลเท่านั้น ชื่อแหล่งข้อมูลที่ระบุรายการผู้ใช้

รูปแบบ: advertisers/{advertiserId}/userLists/{user_list_id}
plannableStatus

enum (PlannableStatus)

แสดงผลเท่านั้น สถานะความสามารถในการวางแผนของรายการผู้ใช้

UserListType

ประเภทของรายการผู้ใช้

Enum
USER_LIST_TYPE_UNSPECIFIED ประเภทรายการผู้ใช้ที่ไม่ได้ระบุ
FIRST_PARTY รายการผู้ใช้ของบุคคลที่หนึ่ง
THIRD_PARTY รายการผู้ใช้ของบุคคลที่สาม

PlannableStatus

สถานะที่ระบุว่ารายการวางแผนได้หรือไม่

Enum
PLANNABLE_STATUS_UNSPECIFIED สถานะความสามารถในการวางแผนที่ไม่ได้ระบุ
PLANNABLE รายการผู้ใช้วางแผนได้
UNPLANNABLE รายการผู้ใช้วางแผนไม่ได้