[comment]: # translation:outdated

[comment]: # ({554f8ab9-554f8ab9})
# תמונה.קבל

[comment]: # ({/554f8ab9-554f8ab9})

[comment]: # ({ef6436a6-ef6436a6})
### תיאור

`integer/array image.get(object parameters)`

השיטה מאפשרת לשלוף תמונות לפי הפרמטרים הנתונים.

::: noteclassic
שיטה זו זמינה למשתמשים מכל סוג. הרשאות
כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה [משתמש
תפקידים](/manual/web_interface/frontend_sections/administration/user_roles)
למידע נוסף.
:::

[comment]: # ({/ef6436a6-ef6436a6})

[comment]: # ({4c8752cd-ac7ee93f})
### פרמטרים

`(object)` פרמטרים המגדירים את הפלט הרצוי.

השיטה תומכת בפרמטרים הבאים.

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|imageids|string/array|החזר רק תמונות עם המזהים הנתונים.|
|sysmapids|string/array|החזר תמונות המשמשות במפות הנתונות.|
|select\_image|flag|החזר מאפיין `image` עם התמונה המקודדת Base64.|
|sortfield|string/array|מיין את התוצאה לפי המאפיינים הנתונים.<br><br>ערכים אפשריים הם: `imageid` ו`name`.|
|countOutput|boolean|הפרמטרים הללו, המשותפים לכל שיטות ה-'get', מתוארים בפירוט ב[פירוש ההתייחסות](/manual/api/reference_commentary#common_get_method_parameters).|
|עריכה|בוליאנית|^|
|excludeSearch|בולאני|^|
|filter|object|^|
|limit|מספר שלם|^|
|פלט|שאילתה|^|
|preservekeys|בולאני|^|
|חיפוש|אובייקט|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|בוליאני|^|
|sortorder|מחרוזת/מערך|^|
|startSearch|boolean|^|

[comment]: # ({/4c8752cd-ac7ee93f})

[comment]: # ({7223bab1-7223bab1})
### החזר ערכים

`(מספר שלם/מערך)` מחזיר אחד:

- מערך של חפצים;
- ספירת האובייקטים שאוחזרו, אם יש לפרמטר `countOutput`
     נעשה שימוש.

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### דוגמאות

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({163fd837-d6cd6c58})
#### אחזר תמונה

אחזר את כל הנתונים לתמונה עם מזהה "2".

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "image.get",
     "params": {
         "output": "להרחיב",
         "select_image": נכון,
         "imageids": "2"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": [
         {
             "imageid": "2",
             "imagetype": "1",
             "name": "Cloud_(24)",
             /aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAAASUVORK5CYII="
         }
     ],
     "מזהה": 1
}
```

[comment]: # ({/163fd837-d6cd6c58})

[comment]: # ({ade21c34-ade21c34})
### מקור

CImage::get()‎ בתוך *ui/include/classes/api/services/CImage.php*.

[comment]: # ({/ade21c34-ade21c34})