החל מ-8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין בדף ההוצאה משימוש.
גודל הדף המבוקש. חייב להיות בין 1 לבין 200. אם לא צוין ערך, ברירת המחדל היא 100.
pageToken
string
אסימון שמזהה דף תוצאות שהשרת אמור להציג. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת לשיטה users.list. אם לא יצוין, יוצג דף התוצאות הראשון.
orderBy
string
השדה שלפיו רוצים למיין את הרשימה. הערכים הקבילים הם:
displayName (ברירת מחדל)
סדר המיון שמוגדר כברירת מחדל הוא עולה. כדי לציין סדר יורד בשדה, צריך להוסיף את הסיומת 'desc' לשם השדה. לדוגמה, displayName desc.
filter
string
מאפשר סינון לפי שדות משתמשים.
תחביר נתמך:
ביטויי מסננים מורכבים מהגבלה אחת או יותר.
אפשר לשלב הגבלות באמצעות האופרטור הלוגי AND.
הפורמט של הגבלה הוא {field} {operator} {value}.
בשדות displayName ו-email צריך להשתמש באופרטור HAS (:).
בשדה lastLoginTime צריך להשתמש באופרטור LESS THAN OR EQUAL TO (<=) או GREATER THAN OR EQUAL TO (>=).
בכל שאר השדות צריך להשתמש באופרטור EQUALS (=).
שדות נתמכים:
assignedUserRole.advertiserId
assignedUserRole.entityType: זהו שדה סינתטי של AssignedUserRole שמשמש לסינון. מזהה את סוג הישות שאליה מוקצה תפקיד המשתמש. הערכים החוקיים הם Partner ו-Advertiser.
assignedUserRole.parentPartnerId: זהו שדה סינתטי של AssignedUserRole שמשמש לסינון. מזהה את שותף ההורה של הישות שאליה מוקצה תפקיד המשתמש.
assignedUserRole.partnerId
assignedUserRole.userRole
displayName
email
lastLoginTime (הזנה בפורמט ISO 8601, או YYYY-MM-DDTHH:MM:SSZ)
דוגמאות:
המשתמש עם displayName שמכיל את 'foo': displayName:"foo"
המשתמש עם email שמכיל את 'bar': email:"bar"
כל המשתמשים עם תפקידי משתמש רגילים: assignedUserRole.userRole="STANDARD"
כל המשתמשים עם תפקידי משתמשים לשותף 123: assignedUserRole.partnerId="123"
כל המשתמשים עם תפקידי משתמש של המפרסם 123: assignedUserRole.advertiserId="123"
כל המשתמשים עם תפקידי משתמשים ברמת השותף: entityType="PARTNER"
כל המשתמשים עם תפקידי משתמשים אצל שותף 123 והמפרסמים שמשויכים לשותף 123: parentPartnerId="123"
כל המשתמשים שהתחברו בפעם האחרונה ב-2023-01-01T00:00:00Z (פורמט ISO 8601) או לאחר מכן: lastLoginTime>="2023-01-01T00:00:00Z"
אסימון לאחזור של דף התוצאות הבא. כדי לאחזר את דף התוצאות הבא, מעבירים את הערך הזה בשדה pageToken בקריאה הבאה לשיטה users.list. האסימון הזה לא יופיע אם אין יותר תוצאות להציג.
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eLists users accessible to the current user, including those with shared roles on partners or advertisers.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination and filtering by user properties like display name, email, assigned roles, and last login time.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video-user-management\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe "Try this method" feature is unavailable for this specific method.\u003c/p\u003e\n"],["\u003cp\u003eSends an HTTP GET request to \u003ccode\u003ehttps://displayvideo.googleapis.com/v3/users\u003c/code\u003e.\u003c/p\u003e\n"]]],["This document details how to list accessible users via a `GET` request to `https://displayvideo.googleapis.com/v3/users`. It requires specific authorization scopes and authentication prerequisites. Query parameters allow for filtering by user fields (`displayName`, `email`, `lastLoginTime`, etc.), sorting (`orderBy`), and pagination (`pageSize`, `pageToken`). The request body must be empty. The successful response contains a list of user objects and a `nextPageToken` for further pagination, if needed.\n"],null,[]]
