שינויים צפויים בתכונה "אישור ממספר משתמשים" ב-Google Ads API

יום רביעי, 4 בנובמבר 2026

מוקדם יותר השנה, התחלנו לדרוש קבלת אישור ממספר משתמשים (MPA) כשמבצעים פעולות רגישות ב-Google Ads API. החל מהשבוע שמתחיל ב-7 בדצמבר 2026, נציג שינויים נוספים כדי לשפר את חוויית המפתחים בתהליך האישור על ידי מספר גורמים.

מה משתנה?

דחיית יצירת הזמנת גישה: אם נדרש אישור ממספר משתמשים, השיטה CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation תדחה את יצירת המשאב של הזמנת הגישה עד שהבקשה לאישור ממספר משתמשים תאושר. במקרים כאלה, השדה resource_name לא מאוכלס. אחרי שמאשרים את בקשת ה-MPA, אפשר לגשת למשאב של ההזמנה דרך תוצאות הבדיקה. נכון לעכשיו, השיטה הזו יוצרת את ההזמנה ומחזירה את ה-resource_name של ההזמנה, אבל לא מבצעת פעולות נוספות כמו שליחת הזמנה באימייל עד שבקשת ה-MPA המשויכת מאושרת.

קוד שגיאה חדש לבקשות לא עדכניות: נתחיל להחזיר קוד שגיאה חדש, MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST, בשדה הכישלון החלקי כשבקשת MPA בהמתנה כבר לא תקפה כי משאב היעד שונה או נמחק אחרי שהבדיקה נוצרה. קוד השגיאה הזה יתווסף בגרסה 26.2 הקרובה. גרסאות API ישנות יותר (גרסה 23 עד גרסה 25) יחזירו שגיאת MultiPartyAuthReviewError.UNKNOWN, והשדה unpublished_error_code ב-GoogleAdsError.details יוגדר כ-MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST.

מגבלות מוגדלות לבדיקות MPA: אתם יכולים לפתור עד 100 בדיקות MPA בהמתנה בקריאה אחת ל-method‏ MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. נכון לעכשיו, השיטה הזו מוגבלת לביקורת אחת לכל קריאה ל-API.

נדרשת פעולה

אם אתם משתמשים בתהליכי אישור על ידי מספר משתמשים, אתם צריכים לבדוק ולעדכן את הקוד שלכם כדי לשקף את ההתנהגות החדשה של ה-API לפני 7 בדצמבר 2026. אם אתם משתמשים בגרסה 26 של Google Ads API, הורידו את ספריות הלקוח העדכניות אחרי ההשקה של גרסה 26.2 כדי לקבל תמיכה בקוד השגיאה החדש STALE_MULTI_PARTY_AUTH_REQUEST. במדריכים הטכניים שלנו מוסבר איך להשתמש בתכונה "אישור על ידי מספר משתמשים". לבעיות שקשורות לתמיכה טכנית, אפשר לפנות אל התמיכה של Google Ads API. אם יש לכם שאלות או שאתם רוצים לדון בפוסט הזה, אתם יכולים לפנות אלינו בשרת ה-Discord של קהילת הפרסום והמדידה של Google.

תוויות: authorization, google-ads-api, release