رابط برنامهنویسی کاربردی گوگل ادز (Google Ads API) از پیوند دادن حسابهای گوگل ادز به سایر حسابهای محصول پشتیبانی میکند. این راهنما نحوه استفاده از API برای پیوند دادن حسابهای شما را توضیح میدهد.
راههای پیوند دادن حسابها
هنگام اتصال یک حساب گوگل ادز به یک حساب محصول دیگر، دو روش مختلف برای اتصال وجود دارد.
جریان دعوت
جریان دعوت زمانی استفاده میشود که شما به حساب گوگل ادز دسترسی ادمین دارید، اما به حساب محصول دسترسی ندارید. این جریان در دو سناریو کار میکند:
- شما میخواهید دو حساب را به هم پیوند دهید و برای مدیر حساب محصول دعوتنامهای ایجاد کنید. مدیر حساب محصول دعوتنامه را برای تکمیل فرآیند پیوند حساب میپذیرد.
- مدیر حساب محصول میخواهد دو حساب را به هم پیوند دهد، اما به حساب Google Ads دسترسی ندارد. مدیر حساب محصول یک دعوتنامه ایجاد میکند و شما دعوتنامه را میپذیرید و فرآیند پیوند را تکمیل میکنید.
در این سناریو از روشهای زیر استفاده میشود:
| سناریو | اکشن | اظهارات |
|---|---|---|
| سناریوی ۱ | ایجاد دعوتنامه | از متد ProductLinkInvitationService.CreateProductLinkInvitation برای ایجاد یک دعوتنامه استفاده کنید. status ProductLinkInvitation نباید تنظیم شود؛ سرور API گوگل ادز پس از اتمام موفقیتآمیز فراخوانی API، این وضعیت را به REQUESTED تنظیم میکند. |
| بررسی وضعیت دعوتنامه | 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 | مشتری اجازه انجام این عمل را ندارد. |
ProductLinkError.NO_INVITATION_REQUIRED | ایجاد دعوتنامه امکانپذیر نیست، زیرا کاربر از قبل به حساب دعوتشده دسترسی مدیر دارد. کاربر باید از ProductLinkService برای ایجاد مستقیم یک لینک فعال استفاده کند. |
جریان لینک مستقیم
جریان لینکدهی مستقیم زمانی استفاده میشود که شما به هر دو حساب گوگل ادز و حساب محصول دسترسی ادمین داشته باشید. در این حالت، شما به جای ارسال دعوتنامه، مستقیماً حساب گوگل ادز را به حساب محصول لینک میکنید.
در این سناریو از روشهای زیر استفاده میشود:
| اکشن | اظهارات |
|---|---|
| ایجاد لینک فعال | برای ایجاد یک ProductLink ProductLinkService.createProductLink استفاده کنید. |
| غیرفعال کردن لینک فعال | برای حذف یک ProductLink فعال، ProductLinkService.removeProductLink استفاده کنید. |
| بازیابی لینکهای فعال | برای جستجوی منبع product_link GoogleAdsService.Search یا GoogleAdsService.SearchStream استفاده کنید. |
خطاهای رایج زیر ممکن است در این گردش کار رخ دهد:
| کد خطا | توضیح |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED | تلاشی برای اتصال حساب کاربری با استفاده از جریان لینک مستقیم انجام شد، اما به دلیل کمبود مجوزها، این روش پشتیبانی نمیشود. کاربر باید به جای آن ProductLinkInvitationService برای انجام جریان دعوت استفاده کند. |
ProductLinkError.INVITATION_EXISTS | ایجاد پیوند امکانپذیر نیست زیرا دعوتنامهای در حال بررسی از قبل وجود دارد. |
پیوندهای محصول موجود را بازیابی کنید
شما میتوانید تمام لینکهای محصول مرتبط با حساب گوگل ادز خود را با استفاده از یک کوئری GAQL در برابر منبع product_link بازیابی کنید.
SELECT
product_link.product_link_id,
product_link.type
FROM product_link
فیلد product_link.type نوع محصول یا خدمات لینک شده را نشان میدهد. بسته به type ، فیلدهای دیگر درون منبع product_link پر میشوند و جزئیات بیشتری در مورد لینک ارائه میدهند. برای مثال، اگر نوع THIRD_PARTY_APP_ANALYTICS باشد، فیلد third_party_app_analytics حاوی اطلاعاتی در مورد ارائه دهنده تجزیه و تحلیل خواهد بود.
این به شما امکان میدهد لیستی از سرویسها و برنامههای خارجی که مستقیماً به حساب Google Ads شما متصل هستند، مانند Google Play، شرکای داده یا پلتفرمهای تجزیه و تحلیل برنامههای شخص ثالث، را دریافت کنید.
تغییرات در AccountLinkService
اگر از AccountLinkService برای پیوند دادن یک حساب Google Ads به یک حساب محصول دیگر استفاده میکنید، باید برنامه موجود خود را به یکی از گردشهای کاری ذکر شده در بالا منتقل کنید. برای انواع لینکهای زیر، از AccountLinkService خارج شده و ProductLinkService استفاده کنید:
-
GoogleAdsIdentifier -
MerchantCenterIdentifier -
AdvertisingPartnerIdentifier
برای ThirdPartyAppAnalyticsLinkIdentifier ، همچنان از AccountLinkService استفاده کنید.