רשימה של טריגרים ידניים שאליה המשתמש הנוכחי יכול לגשת למזהה נתון של המפרסם.
הסדר מוגדר על ידי הפרמטר orderBy
.
יש צורך ב-advertiserId
יחיד.
אזהרה: פריטים שנעשה בהם שימוש בטריגרים ידניים לא מוצגים יותר ב-Display & Video 360. השיטה הזו תוצא משימוש ב-1 באוגוסט 2023. מידע נוסף זמין בהודעה שלנו על הוצאה משימוש של תכונות.
בקשת HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/manualTriggers
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
advertiserId |
חובה. המזהה של המפרסם שאליו שייכים הטריגרים הידניים שאוחזרו. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
pageSize |
גודל הדף המבוקש. חייב להיות בין |
pageToken |
אסימון שמזהה דף של תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של |
orderBy |
שדה שלפיו ממיינים את הרשימה. הערכים הקבילים הם:
סדר המיון שמוגדר כברירת מחדל הוא בסדר עולה. כדי לציין סדר יורד של שדה, צריך להוסיף סיומת 'description' לשם השדה. לדוגמה, |
filter |
מאפשר סינון לפי שדות הפעלה ידנית. תחביר נתמך:
שדות נתמכים:
דוגמאות:
האורך של השדה הזה לא יעלה על 500 תווים. למידע נוסף, אפשר לעיין במדריך שלנו בנושא סינון בקשות |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"manualTriggers": [
{
object ( |
שדות | |
---|---|
manualTriggers[] |
רשימת הטריגרים הידניים. אם הרשימה ריקה, היא לא תופיע. |
nextPageToken |
אסימון לאחזור של דף התוצאות הבא. צריך להעביר את הערך הזה בשדה [pageToken][ListManualTriggersResponse.page_token] בקריאה הבאה ל-method של |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/display-video
למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.