YouTube'u bağlama

Google Ads API, YouTube videolarını Google Ads hesabınıza bağlamayı destekler. Bu kılavuzda, hesabınıza bağlantı eklemek ve hesabınızdan bağlantı kaldırmak için API'nin nasıl kullanılacağı açıklanmaktadır.

Video bağlantısı ekle

Videolar, işlemi kimin başlattığına bağlı olarak iki şekilde hesabınıza bağlanabilir:

1. Bir videonun hesabınıza bağlanmasını isterseniz. Bu senaryoda, içerik üreticiye bir istek gönderirsiniz. İçerik üretici, videosuna bağlantı oluşturmak için bu isteği kabul etmelidir. Süresi uzatılan bir isteği kabul edilmeden önce iptal edebilir ve bağlı bir videoyu kabul edildikten sonra kaldırabilirsiniz.
2. Videonun içerik üreticisi, videosunun Google Ads hesabınıza bağlanmasını ister. Daha sonra bu kullanıcının isteğini kabul edebilir veya reddedebilirsiniz.

Her senaryoda aşağıdaki yöntemler kullanılır:

Senaryo	İşlem	Notlar
Senaryo 1	YouTube API'den video bilgilerini alma	Video bağlantısı isteğini göndereceğiniz channel_id ve bağlamak istediğiniz videonun video_id değerini almak için YouTube API'yi kullanın. video_id, YouTube video URL'lerinde bulunan 11 karakterlik dizedir (örneğin, www.youtube.com/watch?v=VIDEO_ID içindeki v parametresi veya youtu.be/VIDEO_ID içindeki yol).
	Bağlantı isteği oluşturun	Videoyu ve ilişkili kanalını tanımlamak için hem youtube_video.channel_id hem de youtube_video.video_id değerini belirterek bağlantı isteği oluşturmak için DataLinkService.CreateDataLink yöntemini kullanın. v24'ten itibaren, içerik üreticilerin markanızı anlamasına yardımcı olmak için bağlı YouTube marka kanalının kimliğini sağlamak üzere youtube_link_metadata.brand_channel_id de belirtebilirsiniz. DataLink öğesinin status değeri ayarlanmamalıdır. Google Ads API sunucusu, API çağrısı başarıyla tamamlandığında bu değeri REQUESTED olarak ayarlar.
	İsteğin durumunu inceleme	data_link kaynağını sorgulamak ve status değerini incelemek için GoogleAdsService.SearchStream veya GoogleAdsService.Search kullanın.
	İstekleri iptal etme	DataLink öğesinin status değerini REQUESTED yerine REVOKED olarak değiştirerek bağlantı isteğini iptal etmek için DataLinkService.UpdateDataLink yöntemini kullanın.
	Bağlantı kaldırma	Bağlı bir videoyu kaldırmak için DataLinkService.RemoveDataLink simgesini kullanın.
2. senaryo	Davetiye alma	data_link kaynağını sorgulamak için GoogleAdsService.Search veya GoogleAdsService.SearchStream kullanın. Kabul edilecek veya reddedilecek bağlantı isteklerini bulmak için status = PENDING_APPROVAL filtresini uygulayın.
	Bağlantı isteğini kabul etme veya reddetme	İsteği kabul etmek için DataLink durumunu ENABLED, reddetmek içinse REJECTED olarak güncellemek üzere DataLinkService.UpdateDataLink yöntemini kullanın.

Bağlantı ayrıntılarını alma

data_link kaynağını sorgulamak için GoogleAdsService.Search veya GoogleAdsService.SearchStream kullanabilirsiniz. Aşağıdaki sorgu, YouTube video kimliği ve kanal kimliği dahil olmak üzere YouTube video bağlantılarının ayrıntılarını alır:

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'

Bu iş akışında aşağıdaki yaygın hatalar oluşabilir:

Hata kodu	Açıklama
DataLinkError.PERMISSION_DENIED	Müşterinin bu işlemi gerçekleştirme izni yok.
DataLinkError.YOUTUBE_VIDEO_ID_INVALID	Video kimliği geçersiz olduğundan video bağlantısı oluşturulamadı.
DataLinkError.INVALID_STATUS	Veri bağlantısının mevcut durumu istenen işlem için geçersiz olduğunda oluşturulur.
DataLinkError.INVALID_UPDATE_STATUS	Güncelleme sırasında desteklenmeyen bir durum geçişi denenirken (örneğin, doğrudan REVOKED durumundan ENABLED durumuna geçiş) oluşturulur.
MutateError.RESOURCE_ALREADY_EXISTS	Video için zaten bir veri bağlantısı varsa bu hata verilir.