- בקשת HTTP
- פרמטרים של נתיב
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- YoutubeAdGroupAssignedTargetingOption
- רוצים לנסות?
רשימות שהוקצו להן אפשרויות מיקוד עבור קבוצות מודעות מרובות של YouTube בכל סוגי המיקוד.
אפשרויות טירגוט שהועברו בירושה לא נכללות.
בקשת HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/youtubeAdGroups:bulkListAdGroupAssignedTargetingOptions
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
advertiserId |
חובה. המזהה של המפרסם שאליו שייכים הפריטים. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
youtubeAdGroupIds[] |
חובה. המזהים של קבוצות מודעות YouTube שעבורן מוקצות אפשרויות מיקוד. |
pageSize |
אפשרות. גודל הדף המבוקש. הגודל חייב להיות מספר שלם בין |
pageToken |
אפשרות. אסימון שמאפשר ללקוח לאחזר את דף התוצאות הבא. בדרך כלל, זהו הערך של |
orderBy |
אפשרות. שדה שלפיו ממיינים את הרשימה. הערכים הקבילים הם:
סדר המיון שמוגדר כברירת מחדל הוא בסדר עולה. כדי לציין סדר יורד של שדה, צריך להוסיף סיומת 'description' לשם השדה. דוגמה: |
filter |
אפשרות. מאפשר סינון לפי שדות של אפשרויות מיקוד שהוקצו. תחביר נתמך:
שדות נתמכים:
דוגמאות:
האורך של השדה הזה לא יעלה על 500 תווים. למידע נוסף, אפשר לעיין במדריך שלנו בנושא סינון בקשות |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"youtubeAdGroupAssignedTargetingOptions": [
{
object ( |
שדות | |
---|---|
youtubeAdGroupAssignedTargetingOptions[] |
רשימת האובייקטים של wrapper, שכל אחד מהם מספק אפשרות מיקוד שהוקצתה ואת קבוצת המודעות של YouTube שאליה הוא מוקצה. אם הרשימה ריקה, היא לא תופיע. |
nextPageToken |
אסימון שמזהה את דף התוצאות הבא. יש לציין את הערך הזה בתור |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/display-video
למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.
YoutubeAdGroupAssignedTargetingOption
אובייקט wrapper שמשייך משאב AssignedTargetingOption
וקבוצת מודעות YouTube שאליה הוא מוקצה.
ייצוג JSON |
---|
{
"youtubeAdGroupId": string,
"assignedTargetingOption": {
object ( |
שדות | |
---|---|
youtubeAdGroupId |
המזהה של קבוצת המודעות ב-YouTube שאליה מוקצית אפשרות הטירגוט. |
assignedTargetingOption |
המשאב שהוקצה לאפשרות הטירגוט. |