Google Ads API hỗ trợ việc liên kết video trên YouTube với tài khoản Google Ads của bạn. Hướng dẫn này giải thích cách sử dụng API để thêm và xoá các đường liên kết khỏi 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, cụ thể là:
- 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 gửi yêu cầu đến một nhà sáng tạo. Nhà sáng tạo đó phải chấp nhận yêu cầu thì bạn mới có thể liên kết với video của họ. Bạn có thể thu hồi yêu cầu đã gửi trước khi yêu cầu đó được chấp nhận, cũng như xoá video đã liên kết sau khi yêu cầu được chấp nhận.
- Nhà sáng tạo 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 đây được sử dụng trong từng trường hợp:
| Trường hợp | Hành động | Nhận xét |
|---|---|---|
| Trường hợp 1 | Lấy thông tin video từ API YouTube | Sử dụng API YouTube
để lấy channel_id nhằm 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 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 có thể tuỳ ý chỉ định
youtube_video.channel_id để xác định rõ kênh
được liên kết với video và youtube_link_metadata.brand_channel_id
để chỉ định mã kênh YouTube của thương hiệu được liên kết nhằm giúp nhà sáng tạo hiểu rõ về thương hiệu của bạn. Bạn không nên đặt
status
của DataLink; máy chủ Google Ads API sẽ đặt giá trị này thành REQUESTED khi lệnh gọi API hoàn tất thành công. |
|
| 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
DataLinkService.RemoveDataLink để xoá video đã liên kết. |
|
| Trường hợp 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. |
Truy xuất thông tin chi tiết về đường liên kết
Bạn có thể sử dụng
GoogleAdsService.Search
hoặc
GoogleAdsService.SearchStream
để truy vấn tài nguyên data_link.
Truy vấn sau đây sẽ truy xuất thông tin chi tiết về các đường liên kết đến video trên YouTube, bao gồm cả mã nhận dạng kênh YouTube và mã nhận dạng kênh thương hiệu YouTube được liên kết.
SELECT
data_link.resource_name,
data_link.status,
data_link.youtube_video.video_id,
data_link.youtube_video.channel_id,
data_link.youtube_link_metadata.brand_channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'
Bạn có thể gặp phải các lỗi thường gặp sau đây trong quy trình này:
| 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ệ. |