Google Ads API, Google Ads hesaplarının diğer ürün hesaplarına bağlanmasını destekler. Bu kılavuzda, hesaplarınızı bağlamak için API'nın v16 sürümünü nasıl kullanacağınız açıklanmaktadır.
Hesapları bağlama yöntemleri
Bir Google Ads hesabı başka bir ürün hesabına bağlanırken, bağlantı işlemi iki farklı şekilde gerçekleştirilebilir.
Davetiye akışı
Davetiye akışı, Google Ads hesabına yönetici erişiminiz olduğunda kullanılır, ancak ürün hesabına erişiminiz yoktur. Bu akış iki senaryoda işe yarar:
- İki hesabı birbirine bağlayıp ürün hesabının yöneticisi için bir davetiye oluşturmak istiyorsunuz. Ürün hesabı yöneticisi, hesap bağlama işlemini tamamlama davetini kabul eder.
- Ürün hesabı yöneticisi iki hesabı bağlamak istemektedir, ancak Google Ads hesabına erişimi yoktur. Ürün hesabı yöneticisi bir davetiye oluşturur, siz de davetiyeyi kabul edip bağlantı oluşturma işlemini tamamlarsınız.
Bu senaryoda aşağıdaki yöntemler kullanılır:
| Senaryo | İşlem | Notlar |
|---|---|---|
| Senaryo 1 | Davetiye oluşturun | Davetiye oluşturmak için
ProductLinkInvitationService.CreateProductLinkInvitation yöntemini kullanın.
ProductLinkInvitation öğesinin status ayarlanmamalıdır. API çağrısı başarıyla tamamlandığında, Google Ads API sunucusu bunu REQUESTED olarak ayarlar. |
| Davetiyenin durumunu inceleme | product_link_invitation kaynağını sorgulamak ve durumunu incelemek için GoogleAdsService.Search veya GoogleAdsService.SearchStream kullanın. |
|
| Senaryo 2 | Davetiye al | product_link_invitation kaynağını sorgulamak için GoogleAdsService.Search veya GoogleAdsService.SearchStream kullanın. Beklemedeki bir davetiyeyi kabul etmek veya reddetmek için
status = PENDING_APPROVAL
filtresini filtreleyin. |
| Daveti kabul etme veya reddetme |
ProductLinkInvitation öğesinin durumunu ACCEPTED veya REJECTED olarak güncellemek için
ProductLinkInvitationService.UpdateProductLinkInvitation yöntemini kullanın. |
|
| Davetiyeyi iptal etme | Mevcut bir
ProductLinkInvitation öğesini iptal etmek için
ProductLinkInvitationService.RemoveProductLinkInvitation yöntemini kullanın. |
Bu iş akışında aşağıdaki yaygın hatalar verilebilir:
| Hata kodu | Açıklama |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
Müşterinin bu işlemi yapma izni yok. |
ProductLinkError.NO_INVITATION_REQUIRED |
Kullanıcı, davet edilen hesapta yönetici erişimine zaten sahip olduğu için bir davetiye oluşturulamadı. Kullanıcı doğrudan etkin bir bağlantı oluşturmak için ProductLinkService'i kullanmalıdır. |
Doğrudan bağlantı akışı
Doğrudan bağlantı akışı, hem Google Ads hesabına hem de ürün hesabına yönetici erişiminiz olduğunda kullanılır. Bu durumda, davetiye göndermek yerine Google Ads hesabını doğrudan ürün hesabına bağlarsınız.
Bu senaryoda aşağıdaki yöntemler kullanılır:
| İşlem | Notlar |
|---|---|
| Etkin bağlantı oluştur | ProductLink oluşturmak için
ProductLinkService.createProductLink kullanın. |
| Etkin bir bağlantıyı devre dışı bırakma | Etkin bir ProductLink öğesini kaldırmak için
ProductLinkService.removeProductLink kullanın. |
| Etkin bağlantıları al |
product_link kaynağını sorgulamak için
GoogleAdsService.Search veya GoogleAdsService.SearchStream kullanın. |
Bu iş akışında aşağıdaki sık görülen hatalar verilebilir:
| Hata kodu | Açıklama |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Doğrudan bağlantı akışı kullanılarak hesap bağlamaya çalışıldı ancak izin eksikliği nedeniyle bu işlem desteklenmiyor. Kullanıcı, davet akışını gerçekleştirmek için ProductLinkInvitationService kullanmalıdır.
|
ProductLinkError.INVITATION_EXISTS |
Beklemedeki bir davetiye zaten mevcut olduğundan bağlantı oluşturulamıyor. |
AccountLinkService ve MerchantCenterLinkService değişiklikleri
Geçmişte bir Google Ads hesabını başka bir ürün hesabına bağlamak için MerchantCenterLinkService veya AccountLinkService kullandıysanız, mevcut uygulamanızı yukarıda listelenen iş akışlarından birine taşımanız gerekir. Aşağıdaki tabloda taşıma durumu gösterilmektedir:
| Bağlantı türü | Yeni hizmetlerde destekleniyor mu? | Şu tarihten itibaren destek sunulmaktadır: | Notlar |
|---|---|---|---|
DataPartnerIdentifier |
Evet | v15 | MerchantCenterLinkService dışına taşıma |
GoogleAdsIdentifier |
Evet | v16 | AccountLinkService'ten taşıma |
MerchantCenterIdentifier |
Evet | v16 | AccountLinkService'ten taşıma |
AdvertisingPartnerIdentifier |
Evet | v16 | AccountLinkService'ten taşıma |
ThirdPartyAppAnalyticsLinkIdentifier |
Hayır | – | AccountLinkService'i kullanmaya devam et |