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

‫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 כדי לאשר או לדחות הזמנה בהמתנה.
	אישור או דחייה של הזמנה	כדי לעדכן את הסטטוס של ProductLinkInvitation ל-ACCEPTED או ל-REJECTED, משתמשים בשיטה ProductLinkInvitationService.UpdateProductLinkInvitation.
	ביטול הזמנה	משתמשים בשיטה 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.