ลิงก์ YouTube

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

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

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

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

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