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 |