Method: labels.get

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

  • labels/{id} – ראו labels/{id}@latest
  • labels/{id}@latest - מקבל את הגרסה האחרונה של התווית.
  • labels/{id}@published - קבלת הגרסה הנוכחית שפורסמה של התווית.
  • labels/{id}@{revisionId} – מקבל את התווית במזהה הגרסה הקודמת שצוין.

בקשת HTTP

GET https://drivelabels.googleapis.com/v2beta/{name=labels/*}

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

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

פרמטרים
name

string

חובה. שם המשאב של התווית.

יכול להיות אחד מהפרטים הבאים:

  • labels/{id} (שווה ל-Labels/{id}@updated)
  • labels/{id}@latest
  • labels/{id}@published
  • labels/{id}@{revisionId}

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

פרמטרים
useAdminAccess

boolean

כדי להשתמש בפרטי הכניסה של האדמין של המשתמש צריך להגדיר את הערך true. השרת מאמת שהמשתמש הוא אדמין של התווית לפני שהוא מאפשר גישה.

languageCode

string

קוד השפה BCP-47 שבו צריך להשתמש כדי להעריך תוויות של שדות שהותאמו לשוק המקומי. אם היא לא מוגדרת, נעשה שימוש בערכים בשפה שהוגדרה כברירת המחדל.

view

enum (LabelView)

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.labels.readonly
  • https://www.googleapis.com/auth/drive.admin.labels
  • https://www.googleapis.com/auth/drive.admin.labels.readonly

למידע נוסף, עיינו במדריך ההרשאות.