ลิงก์ YouTube

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

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

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

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

สถานการณ์ การดำเนินการ หมายเหตุ
สถานการณ์ที่ 1 ดูข้อมูลวิดีโอจาก API ของ YouTube ใช้ API ของ YouTube เพื่อรับ 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 แสดงขึ้นเมื่อมีลิงก์ข้อมูลสำหรับวิดีโออยู่แล้ว
ก่อนหน้า
ลิงก์บัญชีผลิตภัณฑ์
ถัดไป
เปลี่ยนสถานะ