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'yi nasıl kullanacağınız açıklanmaktadır.
Hesapları bağlama yöntemleri
Bir Google Ads hesabını başka bir ürün hesabına bağlarken iki farklı bağlantı yöntemi vardır.
Davetiye akışı
Google Ads hesabına yönetici erişiminiz varsa ancak ürün hesabına yönetici erişiminiz yoksa davet akışı kullanılır. Bu akış iki senaryoda çalışır:
- İki hesabı bağlamak ve ürün hesabı yöneticisi için davet oluşturmak istiyorsanız. Ürün hesabı yöneticisi, hesap bağlama sürecini tamamlamak için daveti 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. Siz de davetiyeyi kabul edip bağlantı sürecini tamamlarsınız.
Bu senaryoda aşağıdaki yöntemler kullanılır:
| Senaryo | İşlem | Notlar |
|---|---|---|
| Senaryo 1 | Davetiye oluşturma | Davetiye oluşturmak için
ProductLinkInvitationService.CreateProductLinkInvitation yöntemini kullanın. status
ProductLinkInvitation ayarlanmamalıdır. Google Ads API sunucusu, API çağrısı başarılı bir şekilde tamamlandıktan sonra bunu REQUESTED olarak ayarlar. |
| Davetiyenin durumunu inceleme | GoogleAdsService.Search
veya GoogleAdsService.SearchStream
kullanarak product_link_invitation
kaynağını sorgulayın ve durumunu inceleyin. |
|
| Senaryo 2 | Davetiye alma | GoogleAdsService.Search
veya GoogleAdsService.SearchStream
kullanarak product_link_invitation
kaynağını sorgulayın. Bekleyen bir davetiye için
status = PENDING_APPROVAL kabul etme veya reddetme filtresi. |
| Davetiyeleri kabul etme veya reddetme |
ProductLinkInvitationService.UpdateProductLinkInvitation yöntemini kullanarak
ProductLinkInvitation durumunu ACCEPTED veya
REJECTED olarak güncelleyin. |
|
| Davetiyeyi iptal etme | Mevcut bir
ProductLinkInvitation'ı 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 hesaba zaten yönetici erişimine sahip olduğundan davet oluşturulamadı. Kullanıcı, etkin bir bağlantıyı doğrudan 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şturma |
ProductLinkService.createProductLink kullanarak
ProductLink oluşturun. |
| Etkin bir bağlantıyı devre dışı bırakma |
ProductLinkService.removeProductLink simgesini kullanarak etkin bir
ProductLink öğesini kaldırın. |
| Etkin bağlantıları alma |
GoogleAdsService.Search veya
GoogleAdsService.SearchStream
kullanarak
product_link kaynağını sorgulayı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 hesap bağlama işlemi denenmiş ancak izin eksikliği nedeniyle bu işlem desteklenmiyor. Kullanıcı, davet akışını gerçekleştirmek için ProductLinkInvitationService özelliğini kullanmalıdır.
|
ProductLinkError.INVITATION_EXISTS |
Beklemede olan bir davet olduğu için bağlantı oluşturulamıyor. |
AccountLinkService ile ilgili değişiklikler
Bir Google Ads hesabını başka bir ürün hesabına bağlamak için AccountLinkService kullanıyorsanız mevcut uygulamanızı daha önce listelenen iş akışlarından birine taşımanız gerekir. Aşağıdaki bağlantı türleri için AccountLinkService'dan taşıma yapın
ve ProductLinkService'ı kullanın:
GoogleAdsIdentifierMerchantCenterIdentifierAdvertisingPartnerIdentifier
ThirdPartyAppAnalyticsLinkIdentifier için AccountLinkService kullanmaya devam edin.