Method: targetingTypes.targetingOptions.list

• คำขอ HTTP
• พารามิเตอร์เส้นทาง
• พารามิเตอร์การค้นหา
• เนื้อความของคำขอ
• เนื้อหาการตอบกลับ
  • การแสดง JSON
• ขอบเขตการให้สิทธิ์
• ลองใช้งาน

แสดงรายการตัวเลือกการกำหนดเป้าหมายของประเภทหนึ่งๆ

คำขอ HTTP

GET https://displayvideo.googleapis.com/v4/targetingTypes/{targetingType}/targetingOptions

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

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

พารามิเตอร์

targetingType

enum (TargetingType) ต้องระบุ ประเภทตัวเลือกการกำหนดเป้าหมายที่จะแสดง โดยค่าที่ยอมรับมีดังต่อไปนี้ TARGETING_TYPE_APP_CATEGORY TARGETING_TYPE_AGE_RANGE TARGETING_TYPE_GENDER TARGETING_TYPE_VIDEO_PLAYER_SIZE TARGETING_TYPE_USER_REWARDED_CONTENT TARGETING_TYPE_PARENTAL_STATUS TARGETING_TYPE_CONTENT_INSTREAM_POSITION TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_BROWSER TARGETING_TYPE_HOUSEHOLD_INCOME TARGETING_TYPE_ON_SCREEN_POSITION TARGETING_TYPE_CARRIER_AND_ISP TARGETING_TYPE_OPERATING_SYSTEM TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_ENVIRONMENT TARGETING_TYPE_CATEGORY TARGETING_TYPE_VIEWABILITY TARGETING_TYPE_AUTHORIZED_SELLER_STATUS TARGETING_TYPE_LANGUAGE TARGETING_TYPE_GEO_REGION TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION TARGETING_TYPE_EXCHANGE TARGETING_TYPE_SUB_EXCHANGE TARGETING_TYPE_NATIVE_CONTENT_POSITION TARGETING_TYPE_OMID

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

พารามิเตอร์
advertiserId	string (int64 format) ต้องระบุ ผู้ลงโฆษณาที่ส่งคำขอนี้
pageSize	integer ขนาดหน้าที่ต้องการ ต้องอยู่ระหว่าง 1 ถึง 200 หากไม่ระบุ ระบบจะใช้ 100 เป็นค่าเริ่มต้น แสดงรหัสข้อผิดพลาด INVALID_ARGUMENT หากระบุค่าที่ไม่ถูกต้อง
pageToken	string โทเค็นที่ระบุหน้าผลการค้นหาที่เซิร์ฟเวอร์ควรแสดง โดยปกติแล้ว ค่านี้คือค่าของ nextPageToken ที่แสดงผลจากการเรียกใช้เมธอด targetingOptions.list ก่อนหน้านี้ หากไม่ระบุ ระบบจะแสดงหน้าแรกของผลการค้นหา
orderBy	string ฟิลด์สำหรับจัดเรียงรายการ ค่าที่ยอมรับมีดังนี้ targetingOptionId (ค่าเริ่มต้น) ลำดับการจัดเรียงเริ่มต้นคือจากน้อยไปมาก หากต้องการระบุลําดับจากน้อยไปมากสําหรับช่องหนึ่งๆ ให้เพิ่มส่วนต่อท้าย "desc" ต่อท้ายชื่อช่อง ตัวอย่าง: targetingOptionId desc
filter	string อนุญาตให้กรองตามช่องตัวเลือกการกําหนดเป้าหมาย ไวยากรณ์ที่รองรับ นิพจน์ตัวกรองประกอบด้วยข้อจํากัดอย่างน้อย 1 ข้อ คุณสามารถใช้ข้อจํากัดร่วมกันได้ด้วยโอเปอเรเตอร์ทางตรรกะ OR ข้อจํากัดมีรูปแบบเป็น {field} {operator} {value} ฟิลด์ทั้งหมดต้องใช้โอเปอเรเตอร์ EQUALS (=) ฟิลด์ที่รองรับ carrierAndIspDetails.type geoRegionDetails.geoRegionType targetingOptionId ตัวอย่าง ตัวเลือกการกำหนดเป้าหมาย GEO REGION ทั้งหมดที่เป็นประเภทย่อย GEO_REGION_TYPE_COUNTRY หรือ GEO_REGION_TYPE_STATE: geoRegionDetails.geoRegionType="GEO_REGION_TYPE_COUNTRY" OR geoRegionDetails.geoRegionType="GEO_REGION_TYPE_STATE" ตัวเลือกการกำหนดเป้าหมาย CARRIER AND ISP ทั้งหมดที่เป็นประเภทย่อย CARRIER_AND_ISP_TYPE_CARRIER: carrierAndIspDetails.type="CARRIER_AND_ISP_TYPE_CARRIER" ความยาวของช่องนี้ไม่ควรเกิน 500 อักขระ ดูข้อมูลเพิ่มเติมได้ที่คู่มือกรองคำขอ LIST

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

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

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

ข้อความตอบกลับสำหรับ targetingOptions.list

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

การแสดง JSON
{ "targetingOptions": [ { object (TargetingOption) } ], "nextPageToken": string }

ช่อง
targetingOptions[]	object (TargetingOption) รายการตัวเลือกการกำหนดเป้าหมาย รายการนี้จะหายไปหากไม่มีข้อมูล
nextPageToken	string โทเค็นสําหรับดึงข้อมูลหน้าถัดไปของผลการค้นหา ส่งค่านี้ในช่อง pageToken ในการเรียกใช้เมธอด targetingOptions.list ครั้งถัดไปเพื่อดึงข้อมูลหน้าถัดไป

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

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

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

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