YouTube'u bağlama

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

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 ederseniz Bu senaryoda, bir içerik üreticiye istek gönderirsiniz. İçerik üreticinin, videosuna bağlantı oluşturmak için bu isteği kabul etmesi gerekir. Kabul edilmeden önce süresi uzatılmış bir isteği iptal edebilir ve kabul edildikten sonra da bağlı bir videoyu kaldırabilirsiniz.
  2. Videonun içerik üreticisi, videosunun Google Ads hesabınıza bağlanmasını ister. Ardından isteği kabul edebilir veya reddedebilirsiniz.

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

Senaryo İşlem Notlar
1. senaryo YouTube API'den video bilgilerini alma Bağlamak istediğiniz videonun channel_id veya video_id'ünü almak için YouTube API'yi kullanın. video_id, "v=" işaretinden sonraki 11 karakter alınarak bir videonun URL'sinden de çekilebilir.
Bağlantı isteği oluşturun Bağlantı isteği oluşturmak için DataLinkService.CreateDataLink yöntemini kullanın. status DataLink ayarlanmamalıdır. Google Ads API sunucusu, API çağrısı başarılı bir şekilde tamamlandıktan sonra bunu REQUESTED olarak ayarlar.
İsteğin durumunu inceleme GoogleAdsService.SearchStream veya GoogleAdsService.Search kullanarak data_link kaynağını sorgulayın ve status inceleyin.
İsteği iptal etme DataLinkService.UpdateDataLink yöntemini kullanarak bağlantı isteğini iptal etmek için DataLink öğesinin status değerini REQUESTED'dan REVOKED'a değiştirin.
Bağlantı kaldırma Bağlı bir videoyu kaldırmak için DataLinkService.RemoveDataLink simgesini kullanın.
2. senaryo Davetiye alma GoogleAdsService.Search veya GoogleAdsService.SearchStream kullanarak data_link kaynağını sorgulayın. Kabul edilecek veya reddedilecek bağlantı isteklerini bulmak için status = PENDING_APPROVAL simgesini kullanarak filtreleyin.
Bağlantı isteklerini kabul etme veya reddetme İsteği kabul etmek için DataLinkService.UpdateDataLink yöntemini kullanarak DataLink durumunu ENABLED olarak, reddetmek içinse REJECTED olarak güncelleyin.

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ı.