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 kaldırmak için API'nin nasıl kullanılacağı açıklanmaktadır.
Videoları bağlama
Videolar, işlemi başlatan kişiye bağlı olarak hesabınıza iki şekilde bağlanabilir:
- Hesabınıza video bağlama isteğinde bulunabilirsiniz. Bu senaryoda, içerik üreticiye bir istek gönderirsiniz. İçerik üreticinin, videonun bağlantısını oluşturmak için bu isteği kabul etmesi gerekir. Süresi uzatılmış bir isteği kabul edilmeden önce iptal edebilir ve bağlı bir videoyu kabul edildikten sonra kaldırabilirsiniz.
- Videonun sahibi, videonun Google Ads hesabınıza bağlanmasını ister. Ardından, isteği kabul etmeyi veya reddetmeyi seçebilirsiniz.
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 kimliğini veya bağlamak istediğiniz videonun video_id kimliğini almak için YouTube API'yi kullanın. video_id, "v="'den sonraki 11 karakteri alarak da videonun URL'sinden alınabilir. |
| Bağlantı isteği oluşturun | Bağlantı isteği oluşturmak için
DataLinkService.CreateDataLink yöntemini kullanın. DataLink değerinin status değeri ayarlanmamalıdır. Google Ads API sunucusu, API çağrısının başarıyla tamamlanmasının ardından 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 değerini 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ıyı kaldırma | Bağlı bir videoyu kaldırmak için
DataLinkService.RemoveDataLink simgesini kullanın. |
|
| Senaryo 2 | Davetiyeyi alma | data_link
kaynağını sorgulamak için GoogleAdsService.Search
veya GoogleAdsService.SearchStream
kullanın. Kabul etmek veya reddetmek istediğiniz bağlantı isteklerini bulmak için
status = PENDING_APPROVAL değerini filtreleyin. |
| Bağlantı isteklerini kabul etme veya reddetme | İsteği kabul etmek için DataLink durumunu ENABLED olarak, reddetmek içinse REJECTED olarak güncellemek üzere
DataLinkService.UpdateDataLink yöntemini kullanın. |
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ğu için video bağlantısı oluşturulamadı. |