API Google Ads hỗ trợ việc liên kết video trên YouTube với tài khoản Google Ads. Hướng dẫn này giải thích cách sử dụng API để thêm và xoá đường liên kết đến tài khoản của bạn.
Liên kết video
Bạn có thể liên kết video với tài khoản của mình theo một trong hai cách, tuỳ thuộc vào người bắt đầu quy trình:
- Bạn yêu cầu liên kết một video với tài khoản của mình. Trong trường hợp này, bạn sẽ gửi yêu cầu đến nhà sáng tạo. Họ phải chấp nhận yêu cầu này thì bạn mới có thể thiết lập mối liên kết đến video của họ. Bạn có thể thu hồi một yêu cầu đã được gia hạn trước khi yêu cầu đó được chấp nhận, cũng như xoá một video đã được liên kết sau khi yêu cầu đó được chấp nhận.
- Nhà sáng tạo của video yêu cầu liên kết video của họ với tài khoản Google Ads của bạn. Sau đó, bạn có thể chọn chấp nhận hoặc từ chối yêu cầu của họ.
Các phương thức sau được sử dụng trong mỗi trường hợp:
| Trường hợp | Hành động | Nhận xét |
|---|---|---|
| Kịch bản 1 | Lấy thông tin video từ API YouTube | Sử dụng API YouTube để lấy channel_id gửi yêu cầu liên kết video đến hoặc video_id của video bạn muốn liên kết. Bạn cũng có thể lấy video_id từ URL của một video bằng cách lấy 11 ký tự sau "v=". |
| Tạo yêu cầu liên kết | Sử dụng phương thức
DataLinkService.CreateDataLink để tạo yêu cầu liên kết. Bạn không nên đặt status của DataLink; máy chủ API Google Ads sẽ đặt giá trị này thành REQUESTED khi lệnh gọi API hoàn tất. |
|
| Kiểm tra trạng thái của yêu cầu | Sử dụng GoogleAdsService.SearchStream hoặc GoogleAdsService.Search để truy vấn tài nguyên data_link và kiểm tra
status của tài nguyên đó. |
|
| Thu hồi yêu cầu | Sử dụng phương thức
DataLinkService.UpdateDataLink để thu hồi yêu cầu liên kết bằng cách thay đổi status của
DataLink từ REQUESTED thành REVOKED. |
|
| Xoá đường liên kết | Sử dụng biểu tượng
DataLinkService.RemoveDataLink để xoá một video đã liên kết. |
|
| Kịch bản 2 | Truy xuất lời mời | Sử dụng GoogleAdsService.Search hoặc GoogleAdsService.SearchStream để truy vấn tài nguyên data_link. Lọc theo
status = PENDING_APPROVAL để tìm các yêu cầu liên kết cần chấp nhận hoặc từ chối. |
| Chấp nhận hoặc từ chối yêu cầu liên kết | Sử dụng phương thức
DataLinkService.UpdateDataLink để cập nhật trạng thái của DataLink thành ENABLED để chấp nhận hoặc REJECTED để từ chối yêu cầu. |
Quy trình công việc này có thể gặp phải các lỗi thường gặp sau:
| Mã lỗi | Giải thích |
|---|---|
DataLinkError.PERMISSION_DENIED |
Khách hàng không có quyền thực hiện hành động này. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
Không tạo được đường liên kết đến video vì mã video không hợp lệ. |