Method: devices.create

יצירת מכשיר אווירה בחשבון Google Photos של המשתמש.

אם כבר קיים מכשיר עם הערך של requestId שצוין, תוחזר שגיאה מסוג ALREADY_EXISTS. כדי למנוע כפילויות של מכשירים, יש לבצע את הפעולות הבאות:

אם אתם יודעים מהו deviceId של המכשיר הקיים, תוכלו לקרוא ל-devices.get כדי לאחזר אותו.
אם לא ידוע לכם מהו הערך של deviceId, צריך לבצע קריאה ל-devices.delete עם הערך של requestId כדי להסיר את המכשיר היתום לפני שמנסים שוב את השיטה הזו.

אפשר ליצור עד 100 מכשירים לכל משתמש באפליקציה. אם חורגים מהמגבלה הזו, תוחזר שגיאה מסוג RESOURCE_EXHAUSTED.

POST https://photosambient.googleapis.com/v1/devices

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

פרמטרים

פרמטרים
`requestId`	`string` אופציונלי. מזהה ייחודי של הבקשה הזו שסופק על ידי הלקוח. הוא משמש כדי לצמצם את הכפילויות של המשאבים במקרה של כשל ברשת. המזהה הזה חייב להיות בפורמט של מחרוזת UUID (גרסה 4) ולעמוד בדרישות הבאות: אסור לכלול מידע רגיש ומזהה על המשתמש. חייב להכיל 32 תווים הקסדצימליים שמחולקים לחמש קבוצות מופרדות במקפים, בפורמט 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' (או 8-4-4-4-12).

requestId

string

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

המזהה הזה חייב להיות בפורמט של מחרוזת UUID (גרסה 4) ולעמוד בדרישות הבאות:

אסור לכלול מידע רגיש ומזהה על המשתמש.
חייב להכיל 32 תווים הקסדצימליים שמחולקים לחמש קבוצות מופרדות במקפים, בפורמט 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' (או 8-4-4-4-12).

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

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

נדרשת הרשאת OAuth ברמה הבאה:

Method: devices.create קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.