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

Davet 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 çalışır:

1. İki hesabı bağlamak ve ürün hesabının yöneticisi için davetiye oluşturmak istiyorsunuz. Ürün hesabı yöneticisi, hesap bağlama sürecini tamamlamak için davetiyeyi 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ı işlemini tamamlarsınız.

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

Senaryo	İşlem	Notlar
Senaryo 1	Davet oluşturma	Davetiye oluşturmak için ProductLinkInvitationService.CreateProductLinkInvitation yöntemini kullanın. ProductLinkInvitation değerinin status özelliği ayarlanmamalıdır. Google Ads API sunucusu, API çağrısının başarıyla tamamlanmasının ardından bu özelliği REQUESTED olarak ayarlar.
	Davetiyenin durumunu inceleme	product_link_invitation kaynağını sorgulamak ve durumunu incelemek için GoogleAdsService.Search veya GoogleAdsService.SearchStream seçeneğini kullanın.
Senaryo 2	Davetiyeyi alma	product_link_invitation kaynağını sorgulamak için GoogleAdsService.Search veya GoogleAdsService.SearchStream 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 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ışı

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 bir bağlantı oluşturma	ProductLink oluşturmak için ProductLinkService.createProductLink simgesini 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 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
ProductLinkError.INVITATION_EXISTS	Beklemedeki bir davetiye olduğu için bağlantı oluşturulamıyor.

AccountLinkService'te yapılan 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'ten geçiş yapın ve ProductLinkService'u kullanın:

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

ThirdPartyAppAnalyticsLinkIdentifier için AccountLinkService'ü kullanmaya devam edin.