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

‫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.
	ביטול הזמנה	משתמשים ב-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	אי אפשר ליצור קישור כי כבר יש הזמנה בהמתנה.

אחזור קישורים קיימים למוצרים

אפשר לאחזר את כל קישורי המוצרים שמשויכים לחשבון Google Ads באמצעות שאילתת 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.