Method: advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.list

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

คำขอ HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems/{linkedEntity.lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations

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

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

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

string (int64 format)

ต้องระบุ รหัสของผู้ลงโฆษณาที่เอนทิตีที่ลิงก์เป็นของ
พารามิเตอร์ Union entity เอนทิตีที่จะเชื่อมโยงกับเนื้อหา YouTube entity ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
linkedEntity.lineItemId

string (int64 format)

รหัสของสินค้าในรายการสั่งซื้อ
youtubeAssetType

enum (YoutubeAssetType)

ต้องระบุ ประเภทของเนื้อหา YouTube ที่เชื่อมโยงกับแหล่งข้อมูล

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

พารามิเตอร์
พารามิเตอร์ Union entity เอนทิตีที่จะเชื่อมโยงกับเนื้อหา YouTube entity ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
linkedEntity.adGroupId

string (int64 format)

รหัสของกลุ่มโฆษณา
pageSize

integer

ไม่บังคับ ขนาดหน้าที่ขอ ต้องอยู่ระหว่าง 1 ถึง 10000 หากไม่ได้ระบุ ระบบจะใช้ 100 เป็นค่าเริ่มต้น แสดงรหัสข้อผิดพลาด INVALID_ARGUMENT หากระบุค่าที่ไม่ถูกต้อง
pageToken

string

ไม่บังคับ โทเค็นที่ระบุหน้าผลลัพธ์ที่เซิร์ฟเวอร์ควรแสดง

โดยปกติแล้ว ค่านี้คือค่าของ nextPageToken ที่แสดงผลจากการเรียกใช้เมธอด youtubeAssetAssociations.list ครั้งก่อน หากไม่ได้ระบุ ระบบจะแสดงผลหน้าแรกของผลการค้นหา
orderBy

string

ไม่บังคับ ฟิลด์ที่ใช้จัดเรียงรายการ

ค่าที่ยอมรับได้มีเพียงค่าต่อไปนี้

  • linkedYoutubeAsset.locationAssetFilter.assetSetId
  • linkedYoutubeAsset.affiliateLocationAssetFilter.assetSetId
  • linkedYoutubeAsset.sitelinkAsset.assetId

ลำดับการจัดเรียงเริ่มต้นคือจากน้อยไปมาก หากต้องการระบุลำดับจากมากไปน้อยสำหรับฟิลด์ ให้เพิ่มคำต่อท้าย " desc" ในชื่อฟิลด์ ตัวอย่าง: linkedYoutubeAsset.sitelinkAsset.assetId desc

เนื้อความของคำขอ

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

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ ListYoutubeAssetAssociationsResponse

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

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

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

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