קישור חשבונות מוצרים

Google Ads API תומך בקישור של חשבונות Google Ads לחשבונות מוצרים אחרים. במדריך הזה נסביר איך להשתמש ב-API כדי לקשר את החשבונות.

דרכים לקישור חשבונות

כשמקשרים חשבון Google Ads לחשבון מוצר אחר, יש שתי דרכים שונות שבהן הקישור יכול להתבצע.

תהליך ההזמנה

תהליך ההזמנה משמש כשיש לכם הרשאת אדמין בחשבון Google Ads אבל לא בחשבון המוצרים. התהליך הזה פועל בשני תרחישים:

1. אתם רוצים לקשר את שני החשבונות וליצור הזמנה לאדמין של חשבון המוצר. האדמין של חשבון המוצר מקבל את ההזמנה כדי להשלים את תהליך קישור החשבונות.
2. האדמין של חשבון המוצר רוצה לקשר את שני החשבונות, אבל אין לו גישה לחשבון Google Ads. האדמין של חשבון המוצר יוצר הזמנה, ואתם מאשרים את ההזמנה ומסיימים את תהליך הקישור.

בשלב הזה נעשה שימוש בשיטות הבאות:

תרחיש	פעולה	הערות
תרחיש 1	יצירת הזמנה	משתמשים ב-method‏ 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.
	ביטול הזמנה	משתמשים ב-method‏ 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.