Google Ads API תומך בקישור של חשבונות Google Ads לחשבונות במוצרים אחרים. במדריך הזה מוסבר איך להשתמש ב-API כדי לקשר את החשבונות.
איך מקשרים חשבונות
כשמקשרים חשבון Google Ads לחשבון מוצר אחר, יש שתי דרכים שונות לביצוע הקישור.
תהליך ההזמנה
אם יש לכם הרשאת אדמין בחשבון Google Ads אבל לא בחשבון המוצר, אתם יכולים להשתמש בתהליך ההזמנה. התהליך הזה פועל בשני תרחישים:
- אתם רוצים לקשר בין שני החשבונות וליצור הזמנה לאדמין של חשבון המוצר. האדמין של חשבון המוצר מאשר את ההזמנה כדי להשלים את תהליך הקישור של החשבונות.
- האדמין של חשבון המוצר רוצה לקשר בין שני החשבונות, אבל אין לו גישה לחשבון Google Ads. האדמין של חשבון המוצר יוצר הזמנה, ואתם מאשרים את ההזמנה ומשלימים את תהליך הקישור.
במקרה כזה, אפשר להשתמש בשיטות הבאות:
| תרחיש | פעולה | הערות |
|---|---|---|
| תרחיש 1 | יצירת הזמנה | משתמשים ב-method
ProductLinkInvitationService.CreateProductLinkInvitation כדי ליצור הזמנה. לא צריך להגדיר את status
של
ProductLinkInvitation. השרת של Google Ads API
יגדיר את הערך הזה ל-REQUESTED אחרי השלמת
הקריאה ל-API. כשיוצרים הזמנה לשותף לקניית שטחי פרסום (AdvertisingPartnerLinkInvitationIdentifier), צריך להשתמש ב-advertising_partner_properties.allowed_domain החל מגרסה 25 (אופציונלי בגרסה 24 ובגרסאות קודמות). |
| בדיקת הסטטוס של הזמנה | משתמשים ב-GoogleAdsService.Search או ב-GoogleAdsService.SearchStream כדי לשלוח שאילתה למשאב product_link_invitation ולבדוק את הסטטוס שלו. |
|
| תרחיש 2 | שליפת הזמנה | משתמשים ב-GoogleAdsService.Search או ב-GoogleAdsService.SearchStream כדי לשלוח שאילתה למשאב product_link_invitation. מסננים לפי
status = PENDING_APPROVAL כדי לאשר או לדחות
הזמנה בהמתנה. |
| אישור או דחייה של הזמנה | משתמשים ב-method
ProductLinkInvitationService.UpdateProductLinkInvitation כדי לעדכן את הסטטוס של
ProductLinkInvitation ל-ACCEPTED או ל-REJECTED. |
|
| ביטול הזמנה | משתמשים ב-method
ProductLinkInvitationService.RemoveProductLinkInvitation כדי לבטל
ProductLinkInvitation קיים. |
השגיאות הנפוצות הבאות יכולות להופיע בתהליך העבודה הזה:
| קוד שגיאה | הסבר |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
ללקוח אין הרשאה לבצע את הפעולה הזו. |
ProductLinkInvitationError.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 יאוכלסו ויספקו פרטים נוספים על הקישור. לדוגמה, אם הסוג הוא
DATA_PARTNER, השדה data_partner יכיל מידע על
החשבון המקושר של שותף הנתונים.
כך אפשר לקבל רשימה של שירותים חיצוניים וחשבונות מוצרים שמקושרים ישירות לחשבון Google Ads, כמו Merchant Center, Google Ads, שותפים לקניית שטחי פרסום או שותפי נתונים.
שינויים ב-AccountLinkService
אם אתם משתמשים ב-AccountLinkService כדי לקשר חשבון Google Ads לחשבון מוצר אחר, אתם צריכים להעביר את האפליקציה הקיימת לאחד מתהליכי העבודה שצוינו קודם. לסוגי הקישורים הבאים, צריך להפסיק להשתמש ב-AccountLinkService ולעבור ל-ProductLinkService:
ב-ThirdPartyAppAnalyticsLinkIdentifier, ממשיכים להשתמש ב-AccountLinkService.