Liên kết YouTube

API Google Ads 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 mối liên kết khỏi tài khoản của bạn.

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à:

  1. 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 và họ 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 đã được gia hạn trước khi yêu cầu đó được chấp nhận, đồng thời xoá video được liên kết sau khi yêu cầu được chấp nhận.
  2. 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 được dùng trong mỗi trường hợp:

Trường hợp Hành động Nhận xét
Tình huống 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 mà 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 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 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 biểu tượng DataLinkService.RemoveDataLink để xoá một video được 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 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.

Các lỗi phổ biến sau đây có thể xảy ra 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 do mã video không hợp lệ.