Google Ads API از پیوند دادن حساب‌های Google Ads به حساب‌های محصول دیگر پشتیبانی می‌کند. این راهنما توضیح می‌دهد که چگونه از API برای پیوند دادن حساب‌هایتان استفاده کنید.
روش‌های پیوند دادن حساب‌ها
هنگام پیوند دادن حساب Google Ads به حساب محصول دیگر، دو روش مختلف برای انجام پیوند وجود دارد.
جریان دعوت
وقتی به حساب Google Ads دسترسی سرپرست دارید، اما به حساب محصول دسترسی ندارید، از جریان دعوت استفاده کنید. این جریان در دو سناریو کار می‌کند:
- می‌خواهید این دو حساب را پیوند دهید و برای سرپرست حساب محصول دعوت ایجاد کنید. سرپرست حساب محصول دعوت را برای تکمیل فرایند پیوند دادن حساب می‌پذیرد.
- سرپرست حساب محصول می‌خواهد این دو حساب را پیوند دهد، اما به حساب Google Ads دسترسی ندارد. سرپرست حساب محصول دعوتی ایجاد می‌کند و شما دعوت را می‌پذیرید و فرایند پیونددهی را تکمیل می‌کنید.
در این سناریو از روش‌های زیر استفاده کنید:
| سناریو | کنش | اظهار نظرات |
|---|---|---|
| سناریو ۱ | ایجاد دعوت | از روش
ProductLinkInvitationService.CreateProductLinkInvitation
برای ایجاد دعوت استفاده کنید. status
ProductLinkInvitation نباید تنظیم شود؛ سرور «میانای برنامه‌سازی کاربردی Google Ads»
این را پس‌از تکمیل موفقیت‌آمیز
تماس با میانای برنامه‌سازی کاربردی روی REQUESTED تنظیم خواهد کرد. هنگام ایجاد دعوت برای «شریک تبلیغات»
(AdvertisingPartnerLinkInvitationIdentifier)،
advertising_partner_properties.allowed_domain
از نسخه ۲۵ الزامی است (و در نسخه ۲۴ و نسخه‌های قبلی اختیاری است). |
| بررسی وضعیت دعوت | از GoogleAdsService.Search
یا GoogleAdsService.SearchStream
برای پُرسمان منبع product_link_invitation
و بازرسی وضعیت آن استفاده کنید. |
|
| سناریو ۲ | بازیابی دعوت | برای پُرسمان منبع product_link_invitation
از GoogleAdsService.Search
یا GoogleAdsService.SearchStream
استفاده کنید. برای پذیرفتن یا رد کردن دعوت معلقه،
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 |
پیوند ایجاد نشد زیرا دعوت معلقی ازقبل وجود دارد. |
بازیابی پیوندهای محصول موجود
بااستفاده از پرسمان GAQL دربرابر منبع product_link می‌توانید همه پیوندهای محصول منسوب به حساب Google Ads خود را بازیابی کنید.
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 ادامه دهید.