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ğlamanın yolları
Bir Google Ads hesabını başka bir ürün hesabına bağlarken, bağlantı iki farklı şekilde gerçekleşebilir.
Davetiye akışı
Davet akışı, Google Ads hesabına yönetici erişiminiz varsa ancak ürün hesabına erişiminiz yoksa kullanılır. Bu akış iki senaryoda işler:
- İ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 sürecini tamamlama davetini kabul eder.
- Ürün hesabı yöneticisi iki hesabı bağlamak istiyor ancak Google Ads hesabına erişimi yok. Ürün hesabı yöneticisi bir davetiye oluşturur ve siz de daveti kabul ederek 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 değeri ayarlanmamalıdır. API çağrısı başarıyla tamamlandıktan sonra 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 tuşlarını kullanın. |
|
| Senaryo 2 | Davetiye alma | product_link_invitation kaynağını sorgulamak için GoogleAdsService.Search veya GoogleAdsService.SearchStream tuşlarını kullanın. Bekleyen bir davetiyeyi kabul etmek veya reddetmek için
status = PENDING_APPROVAL
filtresini uygulayın. |
| 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 aboneliğini iptal etmek için
ProductLinkInvitationService.RemoveProductLinkInvitation yöntemini kullanın. |
Bu iş akışında aşağıdaki yaygın hatalar oluşabilir:
| Hata kodu | Açıklama |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
Müşterinin bu işlemi gerçekleştirme izni yok. |
ProductLinkError.NO_INVITATION_REQUIRED |
Kullanıcı, davet edilen hesapta yönetici erişimine sahip olduğundan 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 kodunu kullanın. |
| Etkin bağlantıları devre dışı bırakma | Etkin bir
ProductLink
kaldırmak için
ProductLinkService.removeProductLink işlevini kullanın. |
| Etkin bağlantıları al |
product_link kaynağını sorgulamak için
GoogleAdsService.Search veya GoogleAdsService.SearchStream değerini kullanın. |
Bu iş akışında aşağıdaki yaygın hatalar oluşabilir:
| Hata kodu | Açıklama |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Doğrudan bağlantı akışı kullanılarak bir hesap bağlama girişiminde bulunuldu ancak
izin eksikliği nedeniyle bu işlem desteklenmiyor. Kullanıcı, davetiye akışını gerçekleştirmek için ProductLinkInvitationService öğesini kullanmalıdır.
|
ProductLinkError.INVITATION_EXISTS |
Zaten bekleyen bir davetiye olduğu için bağlantı oluşturulamıyor. |
AccountLinkService ve MerchantCenterLinkService'te yapılan değişiklikler
Geçmişte bir Google Ads hesabını başka bir ürün hesabına bağlamak için MerchantCenterLinkService veya AccountLinkService hizmetini kullandıysanız mevcut uygulamanızı daha önce 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 tarih itibarıyla destek sunulmaktadır: | Notlar |
|---|---|---|---|
DataPartnerIdentifier |
Evet | v15 | MerchantCenterLinkService'i taşıyın |
GoogleAdsIdentifier |
Evet | v16 | AccountLinkService dışına taşı |
MerchantCenterIdentifier |
Evet | v16 | AccountLinkService dışına taşı |
AdvertisingPartnerIdentifier |
Evet | v16 | AccountLinkService dışına taşı |
ThirdPartyAppAnalyticsLinkIdentifier |
Hayır | – | AccountLinkService'i kullanmaya devam et |