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 استفاده کنید.