Ürün hesaplarını bağlama

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 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:

1. İki hesabı bağlamak ve ürün hesabı yöneticisi için davetiye oluşturmak istiyorsunuz. Ürün hesabı yöneticisi, hesap bağlama sürecini tamamlamak için daveti kabul eder.
2. Ü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 daveti kabul etmek veya reddetmek için status = PENDING_APPROVAL simgesini kullanın.
	Davetiyeleri kabul etme veya reddetme	ProductLinkInvitationService.UpdateProductLinkInvitation yöntemini kullanarak ProductLinkInvitation durumunu ACCEPTED veya REJECTED olarak güncelleyin.
	Davetiyeyi geri alma	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ğlama 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 kısayolunu kullanarak etkin bir ProductLink 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.

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 THIRD_PARTY_APP_ANALYTICS ise third_party_app_analytics alanında analiz sağlayıcı hakkında bilgiler yer alır.

Bu sayede, Google Ads hesabınıza doğrudan bağlı harici hizmetlerin ve uygulamaların (ör. Google Play, veri iş ortakları veya üçüncü taraf uygulama analiz platformları) 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 ve ProductLinkService'i kullanın:

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

ThirdPartyAppAnalyticsLinkIdentifier için AccountLinkService kullanmaya devam edin.