Google Ads API תומך בקישור חשבונות Google Ads לחשבונות מוצרים אחרים. במדריך הזה נסביר איך להשתמש ב-API כדי לקשר את החשבונות.
דרכים לקישור חשבונות
כשמקשרים חשבון Google Ads לחשבון מוצר אחר, יש שתי דרכים שונות שבהן הקישור יכול להתבצע.
תהליך ההזמנה
תהליך ההזמנה פועל כשיש לכם הרשאת אדמין לחשבון Google Ads אבל לא לחשבון המוצרים. התהליך הזה פועל בשני תרחישים:
- אתם רוצים לקשר בין שני החשבונות וליצור הזמנה לאדמין של חשבון המוצר. מנהל המערכת של חשבון המוצרים מאשר את ההזמנה להשלים את תהליך קישור החשבונות.
- האדמין של חשבון המוצר רוצה לקשר את שני החשבונות, אבל אין לו גישה לחשבון 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. |
|
| ביטול הזמנה | משתמשים בשיטה
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:
GoogleAdsIdentifierMerchantCenterIdentifierAdvertisingPartnerIdentifier
בשביל ThirdPartyAppAnalyticsLinkIdentifier, ממשיכים להשתמש ב-AccountLinkService.