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ı talep edersiniz. 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ı istiyor. Ardından, isteği kabul veya reddedebilirsiniz.

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

Senaryo	İşlem	Notlar
1. senaryo	YouTube API'den video bilgilerini alma	Video bağlantısı isteğinin gönderileceği channel_id ve bağlanmak istediğiniz videonun video_id bilgisini 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. 24. sürümden 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ğerini 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 bir 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	Davetiyeyi geri 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	DataLink durumunu kabul etmek için ENABLED, isteği reddetmek için 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 denenirse (örneğin, doğrudan REVOKED durumundan ENABLED durumuna geçme) bu hata gösterilir.
MutateError.RESOURCE_ALREADY_EXISTS	Video için bir veri bağlantısı zaten mevcut olduğunda oluşturulur.