Google Ads API از پیوند دادن حساب‌های Google Ads به سایر حساب‌های محصول پشتیبانی می‌کند. این راهنما نحوه استفاده از نسخه v16 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 و MerchantCenterLinkService
اگر در گذشته از MerchantCenterLinkService یا AccountLinkService برای پیوند دادن یک حساب Google Ads به حساب محصول دیگری استفاده کرده‌اید، باید برنامه موجود خود را به یکی از گردش‌های کاری فهرست شده قبلی منتقل کنید. جدول زیر وضعیت مهاجرت را نشان می دهد:
| نوع پیوند | در خدمات جدید پشتیبانی می شود؟ | پشتیبانی موجود از تاریخ | ملاحظات |
|---|---|---|---|
DataPartnerIdentifier | آره | v15 | از MerchantCenterLinkService مهاجرت کنید |
GoogleAdsIdentifier | آره | v16 | مهاجرت کردن از AccountLinkService |
MerchantCenterIdentifier | آره | v16 | مهاجرت کردن از AccountLinkService |
AdvertisingPartnerIdentifier | آره | v16 | مهاجرت کردن از AccountLinkService |
ThirdPartyAppAnalyticsLinkIdentifier | خیر | – | به استفاده از AccountLinkService ادامه دهید |