Method: devices.patch

עדכון המידע על המכשיר שצוין.

השגיאה NOT_FOUND תוחזר אם המכשיר לא קיים או שהוא לא בבעלות המשתמש.

בקשת HTTP

PATCH https://photosambient.googleapis.com/v1/devices/{deviceId}

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

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

פרמטרים
deviceId

string

חובה. המזהה הייחודי של המכשיר הזה.

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

פרמטרים
updateMask

string (FieldMask format)

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

לדוגמה, כדי לעדכן את displayName של המכשיר, צריך לספק את נתיב השדה userSettings.displayName ב-updateMask של הבקשה.

אפשר להשתמש בערך המיוחד * כדי לציין שצריך לעדכן את כל השדות (שאפשר לעדכן).

אם לא תמלאו את השדה הזה, המערכת תשתמש במסכה של שדה משתמע שוות ערך לכל השדות שאוכלסו על ידי device (כלומר, להכיל ערך שאינו ריק).

זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"

גוף הבקשה

גוף הבקשה מכיל מופע של AmbientDevice.

גוף התשובה

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

היקפי ההרשאות

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

  • https://www.googleapis.com/auth/photosambient.mediaitems