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ı yöneticisi için davet oluşturmak istiyorsanız. Ü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 davetiye oluşturur. Siz de davetiyeyi kabul edip bağlantı oluşturma sürecini 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. 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. Bir reklamcılık iş ortağı için davetiye oluştururken
(AdvertisingPartnerLinkInvitationIdentifier),
advertising_partner_properties.allowed_domain
v25'ten itibaren zorunlu (v24 ve önceki sürümlerde isteğe bağlı) olacaktır. |
| Davetiyenin durumunu inceleme | GoogleAdsService.Search
veya GoogleAdsService.SearchStream
kullanarak product_link_invitation
kaynağını sorgulayın ve durumunu inceleyin. |
|
| Senaryo 2 | Davetiyeyi geri alma | product_link_invitation kaynağını sorgulamak için GoogleAdsService.Search veya GoogleAdsService.SearchStream kullanın. Bekleyen bir davetiye için
status = PENDING_APPROVAL kabul etme veya reddetme işlemlerini filtreleyin. |
| Davetiyeleri kabul etme veya reddetme |
ProductLinkInvitationService.UpdateProductLinkInvitation yöntemini kullanarak
ProductLinkInvitation durumunu ACCEPTED veya
REJECTED olarak güncelleyin. |
|
| Daveti iptal etme | Mevcut bir
ProductLinkInvitation'yı 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 olduğunda doğrudan bağlama 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 |
ProductLinkService.RemoveProductLink kısayolunu kullanarak etkin bir
ProductLink öğesini kaldırı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 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 desteklenmemektedir. Kullanıcı, davet akışını gerçekleştirmek için ProductLinkInvitationService kullanmalıdır.
|
ProductLinkError.INVITATION_EXISTS |
Bekleyen 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, Merchant Center, Google Ads, reklamcılık iş ortakları veya veri iş ortakları gibi doğrudan Google Ads hesabınıza bağlı harici hizmetlerin ve ürün hesaplarının 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.