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'nin nasıl kullanılacağı açıklanmaktadır.
Hesapları bağlama yöntemleri
Bir Google Ads hesabını başka bir ürün hesabına bağlarken bağlantı iki farklı şekilde gerçekleşebilir.
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ğlantı oluşturma 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ı 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 | Davetiye 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. |
|
| Davetiyeyi geri alma | Mevcut bir
ProductLinkInvitation öğesini 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 bağlantı oluşturma |
ProductLinkService.CreateProductLink kullanarak
ProductLink oluşturun. |
| 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 deneniyor ancak izinler eksik olduğu için bu işlem desteklenmiyor. Kullanıcı, davet akışını yapmak için
ProductLinkInvitationService
işlevini kullanmalıdır.
|
ProductLinkError.INVITATION_EXISTS |
Beklemede olan bir davet olduğu için bağlantı oluşturulamaz. |
Mevcut ürün bağlantılarını alma
product_link kaynağına karşı 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 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ı hakkındaki 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 taşıma yapın
ProductLinkService kullanın:
ThirdPartyAppAnalyticsLinkIdentifier için AccountLinkService kullanmaya devam edin.