Google Ads API תומך בקישור חשבונות Google Ads לחשבונות מוצרים אחרים. במדריך הזה מוסבר איך להשתמש בגרסה 16 של ה-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 |