החל מ-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 כדי לאחזר את דף התוצאות הבא. האסימון הזה לא יופיע אם אין עוד תוצאות להחזרה.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-09-09 (שעון 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,[]]
