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ğlamanın iki farklı yolu vardır.
Davet akışı
Google Ads hesabına yönetici erişiminiz varsa ancak ürün hesabına erişiminiz yoksa davet akışını kullanın. Bu akış iki senaryoda çalışır:
- İki hesabı bağlamak ve ürün hesabının yöneticisi için bir davet oluşturmak istiyorsunuz. Ürün hesabı yöneticisi, hesap bağlama işlemini 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 davet oluşturur, siz de daveti kabul edip bağlantı işlemini tamamlarsınız.
Bu senaryoda aşağıdaki yöntemleri kullanın:
| Senaryo | İşlem | Notlar |
|---|---|---|
| Senaryo 1 | Davetiye oluşturma | Davetiye oluşturmak için
ProductLinkInvitationService.CreateProductLinkInvitation yöntemini
kullanın.
ProductLinkInvitation için status ayarlanmamalıdır. Google Ads API sunucusu, API çağrısı başarıyla tamamlandığında bunu REQUESTED olarak ayarlar. Reklamcılık iş ortağı (AdvertisingPartnerLinkInvitationIdentifier) için davetiye oluştururken advertising_partner_properties.allowed_domain, v25'ten itibaren zorunlu (v24 ve önceki sürümlerde isteğe bağlı) olacaktır. |
| Davetiyenin durumunu inceleme | product_link_invitation kaynağını sorgulamak ve durumunu incelemek için GoogleAdsService.Search veya GoogleAdsService.SearchStream kullanın. |
|
| Senaryo 2 | Davetiyeyi geri alma | product_link_invitation kaynağını sorgulamak için GoogleAdsService.Search veya GoogleAdsService.SearchStream kullanın. Bekleyen bir daveti kabul etmek veya reddetmek için
status = PENDING_APPROVAL filtresini uygulayın. |
| Davetiyeleri kabul etme veya reddetme |
ProductLinkInvitation durumunu ACCEPTED veya REJECTED olarak güncellemek için
ProductLinkInvitationService.UpdateProductLinkInvitation yöntemini kullanın. |
|
| Davetiyeyi iptal etme | Mevcut bir
ProductLinkInvitation'yi 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. |
ProductLinkInvitationError.NO_INVITATION_REQUIRED |
Kullanıcı, davet edilen hesaba zaten yönetici erişimine sahip olduğundan davet oluşturulamadı. Kullanıcı, doğrudan etkin bir bağlantı oluşturmak için ProductLinkService'i kullanmalıdır. |
Doğrudan bağlantı akışı
Hem Google Ads hesabına hem de ürün hesabına yönetici erişiminiz varsa doğrudan bağlantı akışını kullanın. Bu durumda, davetiye göndermek yerine Google Ads hesabını doğrudan ürün hesabına bağlayın.
Bu senaryoda aşağıdaki yöntemleri kullanın:
| İşlem | Notlar |
|---|---|
| Etkin bir bağlantı oluşturma | 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 simgesini kullanın. |
| Etkin bağlantıları alma |
product_link kaynağını sorgulamak için
GoogleAdsService.Search veya GoogleAdsService.SearchStream kullanın. |
Bu iş akışında aşağıdaki yaygın hatalar ortaya çıkabilir:
| Hata kodu | Açıklama |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Doğrudan bağlantı akışı kullanılarak hesap bağlama işlemi denenmiş ancak izinlerin eksik olması nedeniyle bu işlem desteklenmiyor. Kullanıcı, davet akışını gerçekleştirmek için ProductLinkInvitationService kullanmalıdır.
|
ProductLinkError.INVITATION_EXISTS |
Beklemede olan bir davet zaten mevcut olduğundan bağlantı oluşturulamıyor. |
Mevcut ürün bağlantılarını alma
product_link kaynağına yönelik bir GAQL sorgusu kullanarak Google Ads hesabınızla ilişkili tüm ürün bağlantılarını alabilirsiniz.
SELECT
product_link.product_link_id,
product_link.type
FROM product_link
product_link.type alanı, bağlı ürün veya hizmetin türünü gösterir.
type değerine bağlı olarak, product_link kaynağındaki diğer alanlar doldurulur ve bağlantı hakkında daha fazla ayrıntı sağlanır. Örneğin, tür DATA_PARTNER ise data_partner alanı, bağlı veri iş ortağı hesabıyla ilgili bilgileri içerir.
Bu sayede, doğrudan Google Ads hesabınıza bağlı harici hizmetlerin ve ürün hesaplarının (ör. Merchant Center, Google Ads, reklamcılık iş ortakları veya veri iş ortakları) listesini alabilirsiniz.
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'den ProductLinkService'a geçiş yapın:
ThirdPartyAppAnalyticsLinkIdentifier için AccountLinkService kullanmaya devam edin.