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á đườ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à:

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. Nhà sáng tạo đó phải chấp nhận yêu cầu này để thiết lập đường liên kết đến video của họ. Bạn có thể thu hồi yêu cầu đã được gửi trước khi yêu cầu đó được chấp nhận, đồng thời xoá video đã liên kết sau khi video đó đượ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 đâ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 và video_id của video mà bạn muốn liên kết. video_id là chuỗi gồm 11 ký tự có trong URL video trên YouTube (ví dụ: tham số v trong www.youtube.com/watch?v=VIDEO_ID hoặc đường dẫn trong youtu.be/VIDEO_ID).
	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, chỉ định cả youtube_video.channel_id và youtube_video.video_id để xác định video và kênh được liên kết với video đó. Kể từ phiên bản 24, bạn cũng có thể chỉ định youtube_link_metadata.brand_channel_id để cung cấp mã nhận dạng của kênh thương hiệu YouTube đượ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 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ề đường liên kết đến video trên YouTube, bao gồm cả mã video và mã kênh trên 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'

Bạn có thể gặp phải các lỗi thường gặp sau đây trong quy trình làm việc 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ệ.
DataLinkError.INVALID_STATUS	Được gửi khi trạng thái hiện tại của đường liên kết dữ liệu không hợp lệ cho thao tác được yêu cầu.
DataLinkError.INVALID_UPDATE_STATUS	Được gửi khi bạn cố gắng chuyển đổi trạng thái không được hỗ trợ trong quá trình cập nhật (ví dụ: chuyển trực tiếp từ REVOKED sang ENABLED).
MutateError.RESOURCE_ALREADY_EXISTS	Được gửi khi đã tồn tại đường liên kết dữ liệu cho video.