בדף הזה מוסבר איך לקרוא הודעות בכמות גדולה ממאגר HL7v2 באמצעות השיטה projects.locations.datasets.hl7V2Stores.messages.batchGet.
אפשר להשתמש ב-batchGet כדי לאחזר עד 100 הודעות HL7v2 בשיחה אחת.
אפשר להשתמש בהודעה projects.locations.datasets.hl7V2Stores.messages.get כדי לאחזר הודעת HL7v2 אחת בכל פעם, אבל אם יש לכם הרבה הודעות, יכול להיות שתיתקלו בעלויות רשת גבוהות מדי. כדי לאחזר כמה הודעות בקריאה ל-API אחת, משתמשים ב-batchGet.
קבלת הודעות של HL7v2 בכמות גדולה
בדוגמאות הבאות אפשר לראות איך מקבלים את התוכן של הודעות HL7v2 בכמות גדולה.
מידע נוסף זמין במאמר projects.locations.datasets.hl7V2Stores.messages.batchGet.
curl
כדי לקבל הודעות HL7v2 בכמות גדולה, שולחים GET בקשה ומציינים את הפרטים הבאים:
- השם של קבוצת הנתונים הראשית
- השם של מאגר HL7v2
- טוקן גישה
- פרמטר השאילתה
namesעם השמות של הודעות HL7v2 שרוצים לאחזר. לכל ערךnames, מזינים את הנתיב המוגדר במלואו להודעה בפורמט:projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID
בדוגמה הבאה מוצגת בקשת GET באמצעות curl.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID /locations/LOCATION/datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID/messages:batchGet?names=MESSAGE_NAME_1&names=MESSAGE_NAME_2&names= MESSAGE_NAME_3&view=FULL"
אם הבקשה מצליחה, השרת מחזיר את התגובה בפורמט JSON:
{
"messages" : [
{
"name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID"
}
]
}
PowerShell
כדי לקבל הודעות HL7v2 בכמות גדולה, שולחים GET בקשה ומציינים את הפרטים הבאים:
- השם של קבוצת הנתונים הראשית
- השם של מאגר HL7v2
- טוקן גישה
- פרמטר השאילתה
namesעם השמות של הודעות HL7v2 שרוצים לאחזר. לכל ערךnames, מזינים את הנתיב המוגדר במלואו להודעה בפורמט:projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID
בדוגמה הבאה מוצגת בקשת GET באמצעות Windows PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages:batchGet?names=MESSAGE_NAME_1&names=MESSAGE_NAME_2&names=MESSAGE_NAME_3&view=FULL" | Select-Object -Expand Content
אם הבקשה מצליחה, השרת מחזיר את התגובה בפורמט JSON:
{
"messages" : [
{
"name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID"
}
]
}