מחזירה תמונה לפי המזהה שלה.
בקשת HTTP
GET https://solar.googleapis.com/v1/geoTiff:get
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
id |
חובה. המזהה של הנכס המבוקש. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
הודעה שמייצגת גוף HTTP שרירותי. יש להשתמש בו רק בפורמטים של מטען ייעודי (payload) שלא ניתן לייצג כ-JSON, כמו דף בינארי גולמי או דף HTML.
אפשר להשתמש בהודעה הזו גם בשיטות API של סטרימינג וגם בשיטות API שלא קשורות בסטרימינג במסגרת הבקשה, וגם בתגובה.
הוא יכול לשמש כשדה בקשה ברמה העליונה. זהו שדה נוח אם רוצים לחלץ פרמטרים מכתובת האתר או מתבנית HTTP לתוך שדות הבקשה וגם רוצים גישה לגוף ה-HTTP הגולמי.
דוגמה:
message GetResourceRequest {
// A unique request id.
string request_id = 1;
// The raw HTTP body is bound to this field.
google.api.HttpBody http_body = 2;
}
service ResourceService {
rpc GetResource(GetResourceRequest)
returns (google.api.HttpBody);
rpc UpdateResource(google.api.HttpBody)
returns (google.protobuf.Empty);
}
דוגמאות לשיטות סטרימינג:
service CaldavService {
rpc GetCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
rpc UpdateCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
}
שימוש מהסוג הזה משנה רק את אופן הטיפול בבקשות ובגוף התגובה, וכל שאר התכונות ימשיכו לפעול ללא שינוי.
אם הפעולה בוצעה בהצלחה, התגובה היא תגובת HTTP כללית שהפורמט שלה מוגדר על ידי השיטה.
ייצוג JSON |
---|
{ "contentType": string, "data": string, "extensions": [ { "@type": string, field1: ..., ... } ] } |
שדות | |
---|---|
contentType |
ערך הכותרת HTTP Content-Type לציון סוג התוכן של הגוף. |
data |
גוף הבקשה/התגובה של HTTP כבינארי גולמי. מחרוזת בקידוד base64. |
extensions[] |
מטא-נתונים של תגובות ספציפיות לאפליקציה. יש להגדיר זאת בתגובה הראשונה עבור ממשקי API לסטרימינג. אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/cloud-platform