Method: customBiddingAlgorithms.scripts.list

בתיבת הדו-שיח הזו מפורטים סקריפטים של בידינג בהתאמה אישית ששייכים לאלגוריתם הנתון.

הסדר מוגדר על ידי הפרמטר orderBy.

בקשת HTTP

GET https://displayvideo.googleapis.com/v2/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
customBiddingAlgorithmId

string (int64 format)

חובה. המזהה של האלגוריתם של הבידינג בהתאמה אישית הוא הבעלים של הסקריפט.

פרמטרים של שאילתה

פרמטרים
pageSize

integer

גודל הדף המבוקש. חייב להיות בין 1 ל-200. אם לא צוין ערך, ברירת המחדל תהיה 100. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken

string

אסימון שמזהה דף של תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method scripts.list. אם לא מציינים שום אפשרות, יוחזר דף התוצאות הראשון.
orderBy

string

שדה שלפיו ממיינים את הרשימה. הערכים הקבילים הם:

  • createTime desc (ברירת מחדל)

סדר המיון שמוגדר כברירת מחדל הוא יורד. כדי לציין סדר עולה בשדה מסוים, צריך להסיר את הסיומת 'description' (תיאור). דוגמה: createTime
פרמטר איחוד accessor. חובה. מזהה הישות ב-DV360 שנמצאת בבעלותה של אלגוריתם ההורה של בידינג בהתאמה אישית. זה יכול להיות שותף או מפרסם. accessor יכול להיות רק אחד מהבאים:
partnerId

string (int64 format)

המזהה של השותף שהוא הבעלים של אלגוריתם ההורה של בידינג בהתאמה אישית.

רק לשותף הזה תהיה גישת כתיבה לסקריפט של בידינג בהתאמה אישית.
advertiserId

string (int64 format)

המזהה של המפרסם שהוא הבעלים של אלגוריתם ההורה של בידינג בהתאמה אישית.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "customBiddingScripts": [
    {
      object (CustomBiddingScript)
    }
  ],
  "nextPageToken": string
}
שדות
customBiddingScripts[]

object (CustomBiddingScript)

רשימת הסקריפטים של בידינג בהתאמה אישית.

אם הרשימה ריקה, היא לא תופיע.
nextPageToken

string

אסימון לאחזור של דף התוצאות הבא. צריך להעביר את הערך הזה בשדה pageToken בקריאה הבאה ל-method של ListCustomBiddingScriptsRequest כדי לאחזר את דף התוצאות הבא. אם השדה הזה ריק, המשמעות היא שזה הדף האחרון.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/display-video

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.