ลิงก์ YouTube

Google Ads API รองรับการลิงก์วิดีโอ YouTube กับบัญชี Google Ads คู่มือนี้จะอธิบายวิธีใช้ API เพื่อเพิ่มและนำลิงก์ไปยังบัญชีออก

คุณสามารถลิงก์วิดีโอกับบัญชีได้ 2 วิธี โดยขึ้นอยู่กับว่าใครเป็นผู้เริ่มกระบวนการ ดังนี้

  1. คุณขอให้ลิงก์วิดีโอกับบัญชี ในสถานการณ์นี้ คุณจะส่งคำขอไปยังครีเอเตอร์ ซึ่งครีเอเตอร์ต้องยอมรับคำขอดังกล่าวเพื่อสร้างลิงก์ไปยังวิดีโอของตน คุณสามารถเพิกถอนคำขอที่ส่งไปแล้วก่อนที่ครีเอเตอร์จะยอมรับ และนำวิดีโอที่ลิงก์ออกหลังจากที่ครีเอเตอร์ยอมรับแล้วได้ด้วย
  2. ครีเอเตอร์วิดีโอขอให้ลิงก์วิดีโอของตนกับบัญชี Google Ads ของคุณ จากนั้นคุณสามารถเลือกที่จะยอมรับหรือปฏิเสธคำขอได้

ระบบจะใช้วิธีการต่อไปนี้ในแต่ละสถานการณ์

สถานการณ์ การดำเนินการ หมายเหตุ
สถานการณ์ที่ 1 รับข้อมูลวิดีโอจาก API ของ YouTube ใช้ YouTube API เพื่อรับ channel_id สำหรับส่งคำขอลิงก์วิดีโอ และ video_id ของวิดีโอที่ต้องการลิงก์ video_id คือสตริง 11 ตัวอักษรที่พบใน URL ของวิดีโอ YouTube (เช่น พารามิเตอร์ v ใน www.youtube.com/watch?v=VIDEO_ID หรือเส้นทางใน youtu.be/VIDEO_ID)
สร้างคําขอลิงก์ ใช้วิธี DataLinkService.CreateDataLink เพื่อสร้างคำขอลิงก์ โดยระบุทั้ง youtube_video.channel_id และ youtube_video.video_id เพื่อระบุวิดีโอและช่องที่เชื่อมโยง ตั้งแต่ v24 เป็นต้นไป คุณยังระบุ youtube_link_metadata.brand_channel_id เพื่อระบุรหัสของช่อง YouTube ของแบรนด์ที่ลิงก์ไว้เพื่อช่วยให้ครีเอเตอร์ เข้าใจแบรนด์ของคุณได้ด้วย คุณไม่ควรตั้งค่า status ของ DataLink เนื่องจากเซิร์ฟเวอร์ Google Ads API จะตั้งค่านี้เป็น REQUESTED เมื่อการเรียก API เสร็จสมบูรณ์
ตรวจสอบสถานะของคำขอ ใช้ GoogleAdsService.SearchStream หรือ GoogleAdsService.Search เพื่อค้นหาแหล่งข้อมูล data_link ทรัพยากร และตรวจสอบ status
เพิกถอนคำขอ ใช้วิธี DataLinkService.UpdateDataLink เพื่อเพิกถอนคำขอลิงก์โดยเปลี่ยน status ของ DataLink จาก REQUESTED เป็น REVOKED
นำลิงก์ออก ใช้ DataLinkService.RemoveDataLink เพื่อนำวิดีโอที่ลิงก์ออก
สถานการณ์ที่ 2 ดึงข้อมูลคำเชิญ ใช้ GoogleAdsService.Search หรือ GoogleAdsService.SearchStream เพื่อค้นหาแหล่งข้อมูล data_link กรอง status = PENDING_APPROVAL เพื่อค้นหาคำขอลิงก์ ที่จะยอมรับหรือปฏิเสธ
ยอมรับหรือปฏิเสธคำขอลิงก์ ใช้วิธี DataLinkService.UpdateDataLink เพื่ออัปเดตสถานะ ของ DataLink เป็น ENABLED เพื่อยอมรับ หรือ REJECTED เพื่อปฏิเสธคำขอ

ดึงข้อมูลรายละเอียดลิงก์

คุณสามารถใช้ GoogleAdsService.Search หรือ GoogleAdsService.SearchStream เพื่อค้นหาแหล่งข้อมูล data_link การค้นหาต่อไปนี้จะดึงข้อมูลรายละเอียดลิงก์วิดีโอ YouTube ซึ่งรวมถึงรหัสวิดีโอ YouTube และรหัสช่อง

SELECT
  data_link.resource_name,
  data_link.status,
  data_link.youtube_video.video_id,
  data_link.youtube_video.channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'

ข้อผิดพลาดทั่วไปต่อไปนี้อาจเกิดขึ้นในเวิร์กโฟลว์นี้

รหัสข้อผิดพลาด คำอธิบาย
DataLinkError.PERMISSION_DENIED ลูกค้าไม่มีสิทธิ์ดำเนินการนี้
DataLinkError.YOUTUBE_VIDEO_ID_INVALID สร้างลิงก์วิดีโอไม่ได้เนื่องจากรหัสวิดีโอไม่ถูกต้อง
DataLinkError.INVALID_STATUS เกิดขึ้นเมื่อสถานะปัจจุบันของลิงก์ข้อมูลไม่ถูกต้องสำหรับการดำเนินการที่ขอ
DataLinkError.INVALID_UPDATE_STATUS เกิดขึ้นเมื่อพยายามเปลี่ยนสถานะที่ไม่รองรับระหว่างการอัปเดต (เช่น เปลี่ยนจาก REVOKED เป็น ENABLED โดยตรง)
MutateError.RESOURCE_ALREADY_EXISTS เกิดขึ้นเมื่อมีลิงก์ข้อมูลสำหรับวิดีโออยู่แล้ว
ก่อนหน้า
ลิงก์บัญชีผลิตภัณฑ์
ถัดไป
เปลี่ยนสถานะ