בתיבת הדו-שיח הזו מוצגים משתמשים שאפשר לגשת אליהם. אם לשני משתמשים יש תפקידי משתמש באותו שותף או מפרסם, הם יכולים לגשת זה לזה.
לשיטה הזו יש דרישות אימות ייחודיות. לפני שמשתמשים בשיטה הזו, כדאי לקרוא את הדרישות המוקדמות במדריך לניהול משתמשים.
התכונה 'אני רוצה לנסות את השיטה הזו' לא פועלת בשיטה הזו.
בקשת HTTP
GET https://displayvideo.googleapis.com/v1/users
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
pageSize |
גודל הדף המבוקש. חייב להיות בין |
pageToken |
אסימון שמזהה דף תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של |
orderBy |
שדה שלפיו תמיין את הרשימה. הערכים הקבילים הם:
סדר המיון המוגדר כברירת מחדל הוא עולה. כדי לציין סדר יורד לשדה מסוים, צריך להוסיף את הסיומת 'description' לשם השדה. לדוגמה, |
filter |
מאפשר סינון לפי שדות משתמש. תחביר נתמך:
שדות נתמכים:
דוגמאות:
האורך המקסימלי של השדה הזה הוא 500 תווים. מידע נוסף זמין במדריך שלנו בנושא סינון בקשות |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"users": [
{
object ( |
שדות | |
---|---|
users[] |
רשימת המשתמשים. אם הרשימה ריקה, היא לא תופיע. |
nextPageToken |
אסימון לאחזור של דף התוצאות הבא. יש להעביר את הערך הזה בשדה |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/display-video-user-management
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.