Method: advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.list

רשימת השיוכים של נכסי YouTube שמקושרים למשאב הנתון.

בקשת HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems/{linkedEntity.lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
advertiserId

string (int64 format)

חובה. המזהה של המפרסם שאליו שייך הישות המקושרת.
פרמטר של איחוד entity. הישות שרוצים לשייך לנכס ב-YouTube. הערך entity יכול להיות רק אחד מהבאים:
linkedEntity.lineItemId

string (int64 format)

המזהה של פריט.
youtubeAssetType

enum (YoutubeAssetType)

חובה. סוג הנכס ב-YouTube שמשויך למשאב.

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

פרמטרים
פרמטר של איחוד entity. הישות שרוצים לשייך לנכס ב-YouTube. הערך entity יכול להיות רק אחד מהבאים:
linkedEntity.adGroupId

string (int64 format)

המזהה של קבוצת מודעות.
pageSize

integer

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

string

אופציונלי. אסימון שמזהה איזה דף תוצאות השרת צריך להחזיר.

בדרך כלל, זהו הערך של nextPageToken שמוחזר מהקריאה הקודמת לשיטת youtubeAssetAssociations.list. אם לא מציינים ערך, יוצג דף התוצאות הראשון.
orderBy

string

אופציונלי. השדה שלפיו רוצים למיין את הרשימה.

הערכים הקבילים היחידים הם:

  • linkedYoutubeAsset.locationAssetFilter.assetSetId,
  • linkedYoutubeAsset.affiliateLocationAssetFilter.assetSetId,
  • linkedYoutubeAsset.sitelinkAsset.assetId

סדר המיון שמוגדר כברירת מחדל הוא סדר עולה. כדי לציין סדר יורד בשדה, צריך להוסיף את הסיומת ' desc' לשם השדה. דוגמה: linkedYoutubeAsset.sitelinkAsset.assetId desc

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.