پیوند دادن حساب‌های محصول

Google Ads API از پیوند دادن حساب‌های Google Ads به حساب‌های محصولات دیگر پشتیبانی می‌کند. این راهنما توضیح می‌دهد که چگونه از API برای پیوند دادن حساب‌های خود استفاده کنید.

هنگام پیوند دادن حساب Google Ads به حساب محصول دیگر، دو روش مختلف برای پیوند دادن وجود دارد.

جریان دعوت

وقتی به حساب Google Ads دسترسی سرپرست دارید، اما به حساب محصول دسترسی ندارید، از جریان دعوت استفاده کنید. این جریان در دو سناریو کار می‌کند:

  1. می‌خواهید دو حساب را پیوند دهید و دعوتی برای سرپرست حساب محصول ایجاد کنید. سرپرست حساب محصول دعوت را می‌پذیرد تا فرایند پیوند دادن حساب را تکمیل کند.
  2. سرپرست حساب محصول می‌خواهد دو حساب را پیوند دهد، اما به حساب 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 استفاده کنید.