Google Ads API از پیوند دادن حساب‌های Google Ads به حساب‌های محصولات دیگر پشتیبانی می‌کند. این راهنما توضیح می‌دهد که چگونه از API برای پیوند دادن حساب‌های خود استفاده کنید.
روش‌های پیوند دادن حساب‌ها
هنگام پیوند دادن حساب Google Ads به حساب محصول دیگر، دو روش مختلف برای انجام پیوند وجود دارد.
جریان دعوت
وقتی به حساب Google Ads دسترسی سرپرست دارید، اما به حساب محصول دسترسی ندارید، از جریان دعوت استفاده کنید. این جریان در دو سناریو کار می‌کند:
- می‌خواهید دو حساب را پیوند دهید و برای سرپرست حساب محصول دعوت ایجاد کنید. سرپرست حساب محصول دعوت را می‌پذیرد تا فرایند پیوند دادن حساب را تکمیل کند.
- سرپرست حساب محصول می‌خواهد این دو حساب را پیوند دهد، اما به حساب Google Ads دسترسی ندارد. سرپرست حساب محصول دعوتی ایجاد می‌کند و شما دعوت را می‌پذیرید و فرایند پیونددهی را تکمیل می‌کنید.
در این سناریو از روش‌های زیر استفاده کنید:
| سناریو | کنش | اظهار نظرات |
|---|---|---|
| سناریو ۱ | ایجاد دعوت | از روش
ProductLinkInvitationService.CreateProductLinkInvitation
برای ایجاد دعوت استفاده کنید. status
ProductLinkInvitation نباید تنظیم شود؛ سرور Google Ads API
این را پس‌از تکمیل موفقیت‌آمیز
فراخوانی API روی REQUESTED تنظیم خواهد کرد. هنگام ایجاد دعوت برای «شریک تبلیغات»
(AdvertisingPartnerLinkInvitationIdentifier)،
advertising_partner_properties.allowed_domain
از نسخه ۲۵ الزامی است (و در نسخه ۲۴ و نسخه‌های قبلی اختیاری است). |
| بررسی وضعیت دعوت | از GoogleAdsService.Search
یا GoogleAdsService.SearchStream
برای پُرسمان منبع product_link_invitation
و بازرسی وضعیت آن استفاده کنید. |
|
| سناریو ۲ | بازیابی دعوت | از GoogleAdsService.Search
یا GoogleAdsService.SearchStream
برای پرسمان منبع product_link_invitation
استفاده کنید. برای پذیرفتن یا رد کردن دعوت معلقه،
status = PENDING_APPROVAL را فیلتر کنید. |
| پذیرفتن یا رد کردن دعوت | از روش
ProductLinkInvitationService.UpdateProductLinkInvitation برای
به‌روزرسانی وضعیت
ProductLinkInvitation به ACCEPTED یا
REJECTED استفاده کنید. |
|
| لغو کردن دعوت | از روش
ProductLinkInvitationService.RemoveProductLinkInvitation برای
لغو
ProductLinkInvitation موجود استفاده کنید. |
خطاهای رایج زیر ممکن است در این گردش کار رخ دهند:
| کد خطا | توضیح |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
مشتری اجازه اجرای این کنش را ندارد. |
ProductLinkInvitationError.NO_INVITATION_REQUIRED |
دعوت ایجاد نشد، زیرا کاربر ازقبل دسترسی سرپرست به حساب دعوت‌شده دارد. کاربر باید از ProductLinkService برای ایجاد مستقیم پیوند فعال استفاده کند. |
جریان پیوند مستقیم
وقتی به حساب Google Ads و حساب محصول دسترسی سرپرست دارید، از جریان پیوند مستقیم استفاده کنید. در این حالت، به‌جای ارسال دعوت، حساب Google Ads را مستقیماً به حساب محصول پیوند دهید.
در این سناریو از روش‌های زیر استفاده کنید:
| کنش | اظهار نظرات |
|---|---|
| ایجاد پیوند فعال | از
ProductLinkService.CreateProductLink برای ایجاد
ProductLink استفاده کنید. |
| غیرفعال کردن پیوند فعال | از
ProductLinkService.RemoveProductLink برای برداشتن
فعال
ProductLink استفاده کنید. |
| بازیابی پیوندهای فعال | از
GoogleAdsService.Search یا
GoogleAdsService.SearchStream
برای پُرسمان منبع
product_link استفاده کنید. |
خطاهای رایج زیر ممکن است در این گردش کار ایجاد شود:
| کد خطا | توضیح |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
پیوند دادن حساب بااستفاده از جریان پیوند مستقیم انجام شد، اما این کار به‌دلیل نداشتن اجازه‌های لازم پشتیبانی نمی‌شود. کاربر باید از
ProductLinkInvitationService
برای انجام جریان دعوت استفاده کند.
|
ProductLinkError.INVITATION_EXISTS |
پیوند ایجاد نشد زیرا دعوت معلقی ازقبل وجود دارد. |
بازیابی پیوندهای محصول موجود
می‌توانید همه پیوندهای محصول منسوب به حساب Google Ads خود را بااستفاده از
پُرسمان GAQL دربرابر منبع product_link بازیابی کنید.
SELECT
product_link.product_link_id,
product_link.type
FROM product_link
فیلد product_link.type نوع محصول یا سرویس پیوندشده را نشان می‌دهد.
بسته به type، فیلدهای دیگر در منبع product_link تکمیل خواهد شد و جزئیات بیشتری درباره پیوند ارائه خواهد داد. برای مثال، اگر نوع
DATA_PARTNER باشد، فیلد data_partner حاوی اطلاعاتی درباره
حساب شریک داده پیوندشده خواهد بود.
این کار به شما امکان می‌دهد فهرستی از سرویس‌های خارجی و حساب‌های محصولی را که مستقیماً به حساب Google Ads شما پیوند داده شده‌اند، مانند Merchant Center، Google Ads، شرکای تبلیغاتی، یا شرکای داده، دریافت کنید.
تغییرات در AccountLinkService
اگر از AccountLinkService برای پیوند دادن حساب Google Ads به حساب محصول دیگری استفاده می‌کنید، باید برنامه موجودتان را به یکی از گردش کارهای فهرست‌شده در بالا منتقل کنید. برای انواع پیوند زیر، از
AccountLinkService مهاجرت کنید و از ProductLinkService استفاده کنید:
برای ThirdPartyAppAnalyticsLinkIdentifier، به استفاده از
AccountLinkService ادامه دهید.