Ü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'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 bağlantının iki farklı şekilde oluşturulması mümkündür.

Davetiye akışı

Davet akışı, Google Ads hesabına yönetici erişiminiz ancak ürün hesabına erişiminiz olmadığında kullanılır. Bu akış iki senaryoda işler:

1. İki hesabı birbirine bağlayıp ürün hesabının yöneticisi için bir davetiye oluşturmak istiyorsunuz. Ürün hesabı yöneticisi, hesap bağlama sürecini tamamlama davetini 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 ve siz de daveti kabul ederek bağlantı oluşturma işlemini tamamlarsınız.

Bu senaryoda aşağıdaki yöntemler kullanılır:

Senaryo	İşlem	Notlar
Senaryo 1	Davetiye oluşturun	Davetiye oluşturmak için ProductLinkInvitationService.CreateProductLinkInvitation yöntemini kullanın. ProductLinkInvitation öğesinin status değeri ayarlanmamalıdır. API çağrısı başarıyla tamamlandıktan sonra Google Ads API sunucusu, bunu REQUESTED olarak ayarlar.
	Davetiyenin durumunu inceleme	product_link_invitation kaynağını sorgulamak ve durumunu incelemek için GoogleAdsService.Search veya GoogleAdsService.SearchStream tuşlarını kullanın.
Senaryo 2	Davetiye alma	product_link_invitation kaynağını sorgulamak için GoogleAdsService.Search veya GoogleAdsService.SearchStream değerini kullanın. Bekleyen bir davetiyeyi kabul etmek veya reddetmek için status = PENDING_APPROVAL durumunu filtreleyin.
	Davetleri kabul etme veya reddetme	ProductLinkInvitation öğesinin durumunu ACCEPTED veya REJECTED olarak güncellemek için ProductLinkInvitationService.UpdateProductLinkInvitation yöntemini kullanın.
	Davetiyeyi iptal etme	Mevcut bir ProductLinkInvitation'i 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 hesapta yönetici erişimine sahip olduğundan davetiye oluşturulamadı. Kullanıcı, doğrudan etkin bir bağlantı 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ştur	ProductLink oluşturmak için ProductLinkService.createProductLink kodunu kullanın.
Etkin bir bağlantıyı devre dışı bırakma	Etkin bir ProductLink'i 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 değerini 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şlemine çalışıldı ancak bu işlem, izinler olmadığı için desteklenmiyor. Kullanıcı, davet akışını yapmak için ProductLinkInvitationService kullanmalıdır.
ProductLinkError.INVITATION_EXISTS	Zaten bekleyen bir davetiye olduğu için bağlantı oluşturulamıyor.

AccountLinkService değişiklikleri

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 dosyasını taşıyın ve ProductLinkService kullanın:

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

ThirdPartyAppAnalyticsLinkIdentifier için AccountLinkService'ü kullanmaya devam edin.