Google Ads API از پیوند دادن حساب‌های Google Ads به سایر حساب‌های محصول پشتیبانی می‌کند. این راهنما نحوه استفاده از API برای پیوند دادن حساب های خود را توضیح می دهد.
راه های پیوند دادن حساب ها
هنگامی که یک حساب Google Ads را به حساب محصول دیگری پیوند می دهید، دو روش مختلف وجود دارد که از طریق آن پیوند می تواند اتفاق بیفتد.
جریان دعوت
جریان دعوت زمانی استفاده می‌شود که دسترسی سرپرست به حساب Google Ads داشته باشید، اما به حساب محصول دسترسی ندارید. این جریان در دو سناریو کار می کند:
- می‌خواهید این دو حساب را به هم پیوند دهید و دعوت‌نامه‌ای برای سرپرست حساب محصول ایجاد کنید. مدیر حساب محصول دعوت را برای تکمیل فرآیند پیوند دادن حساب می پذیرد.
- سرپرست حساب محصول می‌خواهد این دو حساب را پیوند دهد، اما به حساب Google Ads دسترسی ندارد. مدیر حساب محصول یک دعوت نامه ایجاد می کند و شما دعوت نامه را می پذیرید و فرآیند پیوند را تکمیل می کنید.
در این سناریو از روش های زیر استفاده می شود:
| سناریو | اقدام | اظهارات |
|---|---|---|
| سناریو 1 | دعوت نامه ایجاد کنید | برای ایجاد دعوت نامه از روش ProductLinkInvitationService.CreateProductLinkInvitation استفاده کنید. status ProductLinkInvitation نباید تنظیم شود. سرور Google Ads API این را روی REQUESTED پس از تکمیل موفقیت آمیز تماس API تنظیم می کند. |
| وضعیت یک دعوت نامه را بررسی کنید | از GoogleAdsService.Search یا GoogleAdsService.SearchStream برای پرس و جو از منبع product_link_invitation و بررسی وضعیت آن استفاده کنید. | |
| سناریو 2 | بازیابی دعوت نامه | از GoogleAdsService.Search یا GoogleAdsService.SearchStream برای پرس و جو از منبع product_link_invitation استفاده کنید. فیلتر برای status = PENDING_APPROVAL برای پذیرش یا رد دعوت در انتظار. |
| پذیرش یا رد دعوت | از روش ProductLinkInvitationService.UpdateProductLinkInvitation برای به‌روزرسانی وضعیت ProductLinkInvitation به ACCEPTED یا REJECTED استفاده کنید. | |
| یک دعوت نامه را لغو کنید | از روش ProductLinkInvitationService.RemoveProductLinkInvitation برای لغو یک ProductLinkInvitation موجود استفاده کنید. |
خطاهای رایج زیر را می توان در این گردش کار ایجاد کرد:
| کد خطا | توضیح |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED | مشتری مجوز انجام این عمل را ندارد. |
ProductLinkError.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 | پیوند ایجاد نمی شود زیرا یک دعوت نامه در حال انتظار از قبل وجود دارد. |
تغییرات در AccountLinkService
اگر از AccountLinkService برای پیوند دادن یک حساب Google Ads به حساب محصول دیگری استفاده می‌کنید، باید برنامه موجود خود را به یکی از جریان‌های کاری فهرست شده قبلی منتقل کنید. برای انواع پیوند زیر، از AccountLinkService خارج شده و از ProductLinkService استفاده کنید:
-
GoogleAdsIdentifier -
MerchantCenterIdentifier -
AdvertisingPartnerIdentifier
برای ThirdPartyAppAnalyticsLinkIdentifier ، به استفاده از AccountLinkService ادامه دهید.