Google Ads API รองรับการลิงก์วิดีโอ YouTube กับบัญชี Google Ads คู่มือนี้จะอธิบายวิธีใช้ API เพื่อเพิ่มและนำลิงก์ออกจากบัญชี
ลิงก์วิดีโอ
วิดีโอจะลิงก์กับบัญชีของคุณได้ 2 วิธี ดังนี้ โดยขึ้นอยู่กับว่าใครเป็นผู้เริ่มกระบวนการ
- คุณขอให้ลิงก์วิดีโอกับบัญชี ในกรณีนี้ คุณต้องส่งคำขอไปยังครีเอเตอร์ ซึ่งครีเอเตอร์ต้องยอมรับเพื่อลิงก์กับวิดีโอ คุณสามารถเพิกถอนคำขอที่ขยายเวลาแล้วได้ก่อนที่จะมีการยอมรับ และนำวิดีโอที่ลิงก์ออกได้หลังจากที่มีการยอมรับ
- ครีเอเตอร์ของวิดีโอขอให้ลิงก์วิดีโอกับบัญชี Google Ads ของคุณ จากนั้นคุณจะเลือกยอมรับหรือปฏิเสธคำขอก็ได้
วิธีการต่อไปนี้ใช้ในสถานการณ์แต่ละรายการ
| สถานการณ์ | การดำเนินการ | หมายเหตุ |
|---|---|---|
| สถานการณ์ 1 | รับข้อมูลวิดีโอจาก YouTube API | ใช้ YouTube API เพื่อรับ channel_id สำหรับส่งคำขอลิงก์วิดีโอ หรือ video_id ของวิดีโอที่ต้องการลิงก์ นอกจากนี้ คุณยังดึง video_id จาก URL ของวิดีโอได้โดยดึงอักขระ 11 ตัวหลัง "v=" |
| สร้างคําขอลิงก์ | ใช้วิธีการ
DataLinkService.CreateDataLink
เพื่อสร้างคําขอลิงก์ คุณไม่ควรตั้งค่า 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 เพื่อปฏิเสธคำขอ |
ข้อผิดพลาดที่พบบ่อยต่อไปนี้อาจเกิดขึ้นในเวิร์กโฟลว์นี้
| รหัสข้อผิดพลาด | คำอธิบาย |
|---|---|
DataLinkError.PERMISSION_DENIED |
ลูกค้าไม่ได้รับอนุญาตให้ดำเนินการนี้ |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
สร้างลิงก์วิดีโอไม่ได้เนื่องจากรหัสวิดีโอไม่ถูกต้อง |