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.