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.
Video bağlantısı ekleme
İşlemi başlatan kişiye bağlı olarak videolar, hesabınıza iki şekilde bağlanabilir:
- Bir videonun hesabınıza bağlanmasını isterseniz. 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 uzatılan bir isteği iptal edebilir ve kabul edildikten sonra da bağlı bir videoyu kaldırabilirsiniz.
- 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 | Bağlantı isteği oluşturmak için
DataLinkService.CreateDataLink yöntemini kullanın. Videoyu ve ilişkili kanalını tanımlamak için hem youtube_video.channel_id hem de youtube_video.video_id değerini belirtin.
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
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. |
|
| İstekleri iptal etme |
DataLinkService.UpdateDataLink yöntemini kullanarak
DataLink öğesinin status değerini REQUESTED'den REVOKED'ye değiştirerek bağlantı isteğini iptal edin. |
|
| 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 simgesini kullanarak filtreleyin. |
| 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ıyla ilgili ayrıntıları 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. |