REST Resource: indexing.datasources.items

Zasób: Element

Reprezentuje pojedynczy obiekt, który jest elementem w indeksie wyszukiwania, na przykład plik, folder czy rekord bazy danych.

Zapis JSON
{
  "name": string,
  "acl": {
    object (ItemAcl)
  },
  "metadata": {
    object (ItemMetadata)
  },
  "structuredData": {
    object (ItemStructuredData)
  },
  "content": {
    object (ItemContent)
  },
  "version": string,
  "status": {
    object (ItemStatus)
  },
  "queue": string,
  "payload": string,
  "itemType": enum (Item.ItemType)
}
Pola
name

string

Nazwa elementu. Format: źródła danych/{sourceId}/items/{itemId}

To pole jest wymagane. Maksymalna długość to 1536 znaków.

acl

object (ItemAcl)

Lista kontroli dostępu do tego elementu.

metadata

object (ItemMetadata)

Informacje o metadanych.

structuredData

object (ItemStructuredData)

Uporządkowane dane elementu, które powinny być zgodne z definicją zarejestrowanego obiektu w schemacie źródła danych.

content

object (ItemContent)

Treść elementu, która ma zostać zindeksowana i udostępniona do wyszukiwania.

version

string (bytes format)

To pole jest wymagane. System indeksowania zapisuje wersję ze źródła danych jako ciąg bajtów i porównuje wersję elementu w indeksie z wersją elementu umieszczonego w kolejce przy użyciu kolejności leksycznej.

Indeksowanie Cloud Search nie indeksuje ani nie usuwa żadnych elementów w kolejce, których wersja jest mniejsza lub równa wersji aktualnie zindeksowanego elementu. Maksymalna długość tego pola to 1024 bajty.

Więcej informacji o wpływie wersji produktu na proces usuwania znajdziesz w artykule Obsługa zmian po usunięciu ręcznego.

Ciąg zakodowany w formacie base64.

status

object (ItemStatus)

Stan elementu. Pole tylko do danych wyjściowych.

queue

string

Dodaj do kolejki ten element. Maksymalna długość to 100 znaków.

payload

string (bytes format)

Oprogramowanie sprzęgające stanu dodatkowego może przechowywać ten element. Maksymalna długość to 10 000 bajtów.

Ciąg zakodowany w formacie base64.

itemType

enum (Item.ItemType)

Typ elementu.

ItemAcl

Informacje o liście kontroli dostępu dotyczące elementu. Więcej informacji znajdziesz w temacie Mapowanie list kontroli dostępu (ACL).

Zapis JSON
{
  "inheritAclFrom": string,
  "aclInheritanceType": enum (ItemAcl.AclInheritanceType),
  "readers": [
    {
      object (Principal)
    }
  ],
  "deniedReaders": [
    {
      object (Principal)
    }
  ],
  "owners": [
    {
      object (Principal)
    }
  ]
}
Pola
inheritAclFrom

string

Nazwa elementu, z którego ma być odziedziczona lista uprawnień dostępu. Uwaga: dziedziczenie ACL zapewnia tylko uprawnienia dostępu do elementów podrzędnych, nie definiuje relacji strukturalnych ani nie zapewnia wygodnych sposobów usuwania dużych grup elementów. Usunięcie elementu nadrzędnego listy kontroli dostępu z indeksu zmienia tylko uprawnienia dostępu do elementów podrzędnych, które odwołują się do elementu nadrzędnego w polu inheritAclFrom. Element nadal znajduje się w indeksie, ale może nie być widoczny w wynikach wyszukiwania. Natomiast usunięcie elementu kontenera powoduje też usunięcie wszystkich elementów, które odwołują się do kontenera za pomocą pola containerName. Maksymalna długość tego pola to 1536 znaków.

aclInheritanceType

enum (ItemAcl.AclInheritanceType)

Określa typ reguł dostępu, które mają być stosowane, gdy element dziedziczy listę kontroli dostępu z elementu nadrzędnego. To pole zawsze należy ustawiać w połączeniu z polem inheritAclFrom. Poza tym, gdy pole inheritAclFrom jest ustawione, należy ustawić w tym polu prawidłową wartość AclInheritanceType.

readers[]

object (Principal)

Lista podmiotów zabezpieczeń, które mogą wyświetlać element w wynikach wyszukiwania. Opcjonalne w przypadku dziedziczenia uprawnień z innego elementu lub gdy element nie powinien być widoczny, na przykład w elemencie virtual containers. Maksymalna liczba elementów to 1000.

deniedReaders[]

object (Principal)

Lista podmiotów zabezpieczeń, którym odmówiono dostępu do elementu w wynikach wyszukiwania. Podmioty zabezpieczeń mają domyślnie odmowę dostępu, ale używaj odrzuconych czytelników do obsługi wyjątków i zastępowania użytkowników z listy dozwolonych. Maksymalna liczba elementów to 100.

owners[]

object (Principal)

Opcjonalnie. Lista właścicieli elementu. To pole nie ma wpływu na uprawnienia dostępu do dokumentu. Zapewnia jednak niewielką poprawę pozycji w rankingu wśród elementów, których właścicielem jest użytkownik, który wysłał zapytanie. Maksymalna liczba elementów to 5.

ItemAcl.AclInheritanceType

Typy dziedziczenia ACL.

Wartości w polu enum
NOT_APPLICABLE Wartość domyślna, gdy ten element nie dziedziczy listy ACL. Użyj filtra NOT_APPLICABLE, gdy inheritAclFrom jest pusty. Element bez dziedziczenia ACL może nadal mieć listy kontroli dostępu dostarczane przez własne pola readers i deniedReaders.
CHILD_OVERRIDE W trakcie konfliktu autoryzacji lista kontroli dostępu elementu podrzędnego określa jego uprawnienia do odczytu.
PARENT_OVERRIDE W trakcie konfliktu autoryzacji uprawnienia do odczytu zależą od listy kontroli dostępu (ACL) elementu nadrzędnego określonego w polu inheritAclFrom.
BOTH_PERMIT Dostęp jest przyznawany tylko wtedy, gdy zarówno ten element, jak i element nadrzędny określony w polu inheritAclFrom zezwalają na uprawnienia do odczytu.

Podmiot zabezpieczeń

Odniesienie do użytkownika, grupy lub domeny.

Zapis JSON
{

  // Union field principal can be only one of the following:
  "gsuitePrincipal": {
    object (GSuitePrincipal)
  },
  "userResourceName": string,
  "groupResourceName": string
  // End of list of possible types for union field principal.
}
Pola

Pole sumy principal.

principal może mieć tylko jedną z tych wartości:

gsuitePrincipal

object (GSuitePrincipal)

Ten podmiot zabezpieczeń to użytkownik, grupa lub domena Google Workspace.

userResourceName

string

Ten podmiot zabezpieczeń to użytkownik identyfikowany przy użyciu tożsamości zewnętrznej. Pole nazwy musi zawierać nazwę zasobu użytkownika w formacie: identitysources/{sourceId}/users/{ID}

groupResourceName

string

Ten podmiot zabezpieczeń to grupa identyfikowana za pomocą tożsamości zewnętrznej. Pole nazwy musi określać nazwę zasobu grupy w formacie: identitysources/{sourceId}/groups/{ID}

ItemMetadata

Dostępne pola metadanych elementu.

Zapis JSON
{
  "title": string,
  "sourceRepositoryUrl": string,
  "containerName": string,
  "objectType": string,
  "createTime": string,
  "updateTime": string,
  "interactions": [
    {
      object (Interaction)
    }
  ],
  "contentLanguage": string,
  "mimeType": string,
  "searchQualityMetadata": {
    object (SearchQualityMetadata)
  },
  "keywords": [
    string
  ],
  "hash": string,
  "contextAttributes": [
    {
      object (ContextAttribute)
    }
  ]
}
Pola
title

string

Tytuł produktu. Jeśli zostanie podany, to będzie wyświetlany tytuł wyniku query.search. Maksymalna długość to 2048 znaków.

sourceRepositoryUrl

string

Link do repozytorium źródłowego obsługującego dane. Wyniki wyszukiwania zastosują ten link do tytułu. Odstępy i znaki specjalne mogą powodować, że linki wyników z Cloud Search będą aktywować powiadomienie o przekierowaniu. Aby tego uniknąć, zakoduj adres URL. Maksymalna długość to 2048 znaków.

containerName

string

Nazwa kontenera dla tego elementu. Usunięcie elementu kontenera spowoduje automatyczne usunięcie tego elementu. Uwaga: listy kontroli dostępu nie są dziedziczone z elementu kontenera. Aby określić dziedziczenie listy ACL elementu, użyj pola inheritAclFrom. Maksymalna długość to 1536 znaków.

objectType

string

Typ elementu. Powinna odpowiadać nazwie definicji obiektu w schemacie zarejestrowanym dla źródła danych. Jeśli na przykład schemat źródła danych zawiera definicję obiektu o nazwie „document”, w przypadku żądań indeksowania obiektów tego typu należy ustawić obiektObjectType na „document”. Maksymalna długość to 256 znaków.

createTime

string (Timestamp format)

Czas utworzenia elementu w repozytorium źródłowym.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Czas ostatniej modyfikacji elementu w repozytorium źródłowym.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

interactions[]

object (Interaction)

Lista interakcji związanych z elementem. Interakcje są używane do poprawiania jakości query.search, ale nie są widoczne dla użytkowników. Maksymalna liczba elementów to 1000.

contentLanguage

string

Kod języka produktu w formacie BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Maksymalna długość to 32 znaki.

mimeType

string

Oryginalny typ MIME elementu ItemContent.content w repozytorium źródłowym. Maksymalna długość to 256 znaków.

searchQualityMetadata

object (SearchQualityMetadata)

Dodatkowe metadane dotyczące jakości wyszukiwania elementu

keywords[]

string

Dodatkowe słowa kluczowe lub wyrażenia, które powinny pasować do produktu. Używany wewnętrznie na potrzeby treści użytkowników. Maksymalna liczba elementów to 100. Maksymalna długość to 8192 znaki.

hash

string

Wartość haszowania podana przez element wywołujący interfejs API. Tego parametru można używać z metodą items.push do obliczania zmodyfikowanego stanu. Maksymalna długość to 2048 znaków.

contextAttributes[]

object (ContextAttribute)

Zestaw nazwanych atrybutów powiązanych z produktem. Pozwala to wpływać na pozycję produktu w rankingu na podstawie kontekstu żądania. Maksymalna liczba elementów to 10.

Interakcja

Reprezentuje interakcję między użytkownikiem a elementem.

Zapis JSON
{
  "type": enum (Interaction.InteractionType),
  "principal": {
    object (Principal)
  },
  "interactionTime": string
}
Pola
type

enum (Interaction.InteractionType)

principal

object (Principal)

Użytkownik, który wykonał czynność na elemencie.

interactionTime

string (Timestamp format)

Czas wykonania przez użytkownika działania na elemencie. Jeśli dla jednego użytkownika istnieje wiele działań tego samego typu, rejestrowane jest tylko ostatnie działanie.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

Interaction.InteractionType

Typ działania, które użytkownik wykonał na elemencie.

Wartości w polu enum
UNSPECIFIED Nieprawidłowa wartość.
VIEW Ta interakcja wskazuje, że użytkownik wyświetlił element.
EDIT Ta interakcja wskazuje, że użytkownik zmodyfikował element.

SearchQualityMetadata

Dodatkowe metadane dotyczące jakości wyszukiwania elementu.

Zapis JSON
{
  "quality": number
}
Pola
quality

number

Wskaźnik jakości produktu, który wpływa na jakość wyszukiwania. Wartość powinna mieścić się w przedziale od 0,0 (najniższa jakość) do 1,0 (najwyższa jakość). Wartością domyślną jest 0,0.

ContextAttribute

Nazwany atrybut powiązany z produktem, który może wpływać na pozycję produktu w rankingu na podstawie kontekstu żądania.

Zapis JSON
{
  "name": string,
  "values": [
    string
  ]
}
Pola
name

string

Nazwa atrybutu. To pole nie może być puste. Maksymalna długość to 32 znaki. Nazwa musi zaczynać się od litery i może zawierać tylko litery (A–Z, a–z) oraz cyfry (0–9). Przed dopasowaniem nazwa zostanie znormalizowana (małą literą).

values[]

string

Wartości tekstowe atrybutu. Maksymalna liczba elementów to 10. Maksymalna długość elementu w tablicy to 32 znaki. Przed dopasowaniem wartość zostanie znormalizowana (małymi literami).

ItemStructuredData

Dostępne pola danych strukturalnych dla elementu.

Zapis JSON
{
  "object": {
    object (StructuredDataObject)
  },
  "hash": string
}
Pola
object

object (StructuredDataObject)

Obiekt uporządkowanych danych, który powinien spełniać wymagania definicji zarejestrowanego obiektu w schemacie źródła danych.

hash

string

Wartość haszowania podana przez element wywołujący interfejs API. Tego parametru można używać z metodą items.push do obliczania zmodyfikowanego stanu. Maksymalna długość to 2048 znaków.

StructuredDataObject

Obiekt uporządkowanych danych składający się z właściwości nazwanych.

Zapis JSON
{
  "properties": [
    {
      object (NamedProperty)
    }
  ]
}
Pola
properties[]

object (NamedProperty)

Właściwości obiektu. Maksymalna liczba elementów to 1000.

NamedProperty

Wpisana para nazwa-wartość na potrzeby uporządkowanych danych. Typ wartości powinien być taki sam jak zarejestrowany typ właściwości name w definicji obiektu objectType.

Zapis JSON
{
  "name": string,

  // Union field value can be only one of the following:
  "integerValues": {
    object (NamedProperty.IntegerValues)
  },
  "doubleValues": {
    object (NamedProperty.DoubleValues)
  },
  "timestampValues": {
    object (NamedProperty.TimestampValues)
  },
  "booleanValue": boolean,
  "objectValues": {
    object (NamedProperty.ObjectValues)
  },
  "enumValues": {
    object (NamedProperty.EnumValues)
  },
  "dateValues": {
    object (NamedProperty.DateValues)
  },
  "textValues": {
    object (NamedProperty.TextValues)
  },
  "htmlValues": {
    object (NamedProperty.HtmlValues)
  }
  // End of list of possible types for union field value.
}
Pola
name

string

Nazwa usługi. Ta nazwa powinna odpowiadać nazwie właściwości zarejestrowanej na potrzeby definicji obiektu w schemacie. Maksymalna dopuszczalna długość tej usługi to 256 znaków.

Pole sumy value. Wartości nazwanej właściwości. Pamiętaj, że usługa może zawierać wartości tylko jednego typu. value może mieć tylko jedną z tych wartości:
integerValues

object (NamedProperty.IntegerValues)

doubleValues

object (NamedProperty.DoubleValues)

timestampValues

object (NamedProperty.TimestampValues)

booleanValue

boolean

objectValues

object (NamedProperty.ObjectValues)

enumValues

object (NamedProperty.EnumValues)

dateValues

object (NamedProperty.DateValues)

textValues

object (NamedProperty.TextValues)

htmlValues

object (NamedProperty.HtmlValues)

NamedProperty.IntegerValues

Lista wartości liczb całkowitych.

Zapis JSON
{
  "values": [
    string
  ]
}
Pola
values[]

string (int64 format)

NamedProperty.DoubleValues

Lista wartości liczby zmiennoprzecinkowych.

Zapis JSON
{
  "values": [
    number
  ]
}
Pola
values[]

number

NamedProperty.TimestampValues

Lista wartości sygnatur czasowych.

Zapis JSON
{
  "values": [
    string
  ]
}
Pola
values[]

string (Timestamp format)

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

NamedProperty.ObjectValues

Lista wartości obiektów.

Zapis JSON
{
  "values": [
    {
      object (StructuredDataObject)
    }
  ]
}
Pola
values[]

object (StructuredDataObject)

NamedProperty.EnumValues

Lista wartości wyliczeniowych.

Zapis JSON
{
  "values": [
    string
  ]
}
Pola
values[]

string

Maksymalna dopuszczalna długość wartości ciągu znaków to 32 znaki.

NamedProperty.DateValues

Lista wartości dat.

Zapis JSON
{
  "values": [
    {
      object (Date)
    }
  ]
}
Pola
values[]

object (Date)

NamedProperty.TextValues

Lista wartości tekstowych.

Zapis JSON
{
  "values": [
    string
  ]
}
Pola
values[]

string

Maksymalna dopuszczalna długość wartości tekstowych to 2048 znaków.

NamedProperty.HtmlValues

Lista wartości HTML.

Zapis JSON
{
  "values": [
    string
  ]
}
Pola
values[]

string

Maksymalna dopuszczalna długość wartości HTML to 2048 znaków.

ItemContent

Treść elementu do indeksowania i wyświetlania przez Cloud Search. Jako inlineContent dozwolone są tylko ciągi zakodowane w formacie UTF-8. Jeśli przesyłasz treść, a nie plik binarny, musi być zakodowana w formacie UTF-8.

Zapis JSON
{
  "contentFormat": enum (ItemContent.ContentFormat),
  "hash": string,

  // Union field content can be only one of the following:
  "inlineContent": string,
  "contentDataRef": {
    object (UploadItemRef)
  }
  // End of list of possible types for union field content.
}
Pola
contentFormat

enum (ItemContent.ContentFormat)

hash

string

Informacje o szyfrowaniu treści obliczone i dostarczone przez klienta interfejsu API. Można jej używać z metodą items.push do obliczania zmodyfikowanego stanu. Maksymalna długość to 2048 znaków.

Pole sumy content.

content może mieć tylko jedną z tych wartości:

inlineContent

string (bytes format)

Treści dostarczane w ramach metody aktualizacji. Maksymalna długość to 10 2400 bajtów (100 KiB).

Ciąg zakodowany w formacie base64.

contentDataRef

object (UploadItemRef)

Prześlij identyfikator referencyjny wcześniej przesłanych treści za pomocą metody zapisu.

ItemContent.ContentFormat

Format treści. Jeśli format to RAW, treści powinny być w formacie określonym przez mimeType.

Wartości w polu enum
UNSPECIFIED Nieprawidłowa wartość.
HTML contentFormat to HTML.
TEXT contentFormat to dowolny tekst.
RAW contentFormat to nieprzetworzone bajty.

UploadItemRef

Reprezentuje odwołanie do sesji przesyłania. Ten plik referencyjny został utworzony w usłudze upload method. Ten plik referencyjny jest ważny przez 30 dni od utworzenia. Aktualizacja treści elementu może odnosić się do treści przesłanej przez contentDataRef.

Zapis JSON
{
  "name": string
}
Pola
name

string

Nazwa odwołania do treści. Maksymalna długość to 2048 znaków.

ItemStatus

Zawiera stan elementu i wszelkie błędy.

Zapis JSON
{
  "code": enum (ItemStatus.Code),
  "processingErrors": [
    {
      object (ProcessingError)
    }
  ],
  "repositoryErrors": [
    {
      object (RepositoryError)
    }
  ]
}
Pola
code

enum (ItemStatus.Code)

Kod stanu.

processingErrors[]

object (ProcessingError)

Szczegóły błędu, jeśli element ma stan BŁĄD.

repositoryErrors[]

object (RepositoryError)

Oprogramowanie sprzęgające zgłosił błąd repozytorium.

ProcessingError

Zapis JSON
{
  "code": enum (ProcessingErrorCode),
  "errorMessage": string,
  "fieldViolations": [
    {
      object (FieldViolation)
    }
  ]
}
Pola
code

enum (ProcessingErrorCode)

Kod błędu wskazujący charakter błędu.

errorMessage

string

Opis błędu.

fieldViolations[]

object (FieldViolation)

Jeśli pola elementu są nieprawidłowe, zawiera ono szczegółowe informacje o błędach weryfikacji.

ProcessingErrorCode

Kody wskazujące błąd, który wystąpił podczas przetwarzania elementów przez serwer Cloud Search. Pojedynczy produkt może zawierać wiele błędów przetwarzania.

Wartości w polu enum
PROCESSING_ERROR_CODE_UNSPECIFIED Wartość tylko wejściowa. Użyj tej wartości w sekcji Elementy.
MALFORMED_REQUEST Lista kontroli dostępu (ACL), metadane lub treść elementu mają nieprawidłowy stan. Naruszenie zasad zawiera więcej informacji na temat miejsca wystąpienia problemu.
UNSUPPORTED_CONTENT_FORMAT Format zliczania nie jest obsługiwany.
INDIRECT_BROKEN_ACL Elementy z niepełnymi informacjami na liście kontroli dostępu ze względu na dziedziczenie innych elementów z uszkodzoną listą kontroli dostępu lub posiadanie grup z niezmapowanymi elementami podrzędnymi.
ACL_CYCLE Wykres dziedziczenia ACL utworzył cykl.

FieldViolation

Zapis JSON
{
  "field": string,
  "description": string
}
Pola
field

string

Ścieżka pola z naruszeniem.

description

string

Opis błędu.

RepositoryError

Błędy podczas komunikacji przez oprogramowanie sprzęgające z repozytorium źródłowym.

Zapis JSON
{
  "type": enum (RepositoryError.Type),
  "httpStatusCode": integer,
  "errorMessage": string
}
Pola
type

enum (RepositoryError.Type)

typ błędu;

httpStatusCode

integer

Kody błędów. Odpowiada definicji kodów stanu HTTP.

errorMessage

string

Komunikat opisujący błąd. Maksymalna dopuszczalna długość wiadomości to 8192 znaki.

RepositoryError.Type

Lista kodów błędów związanych z komunikacją z repozytorium.

Wartości w polu enum
UNKNOWN Nieznany błąd.
NETWORK_ERROR Nieznany lub nieosiągalny host.
DNS_ERROR Problem z DNS, na przykład serwer DNS nie odpowiada.
CONNECTION_ERROR Nie można połączyć się z serwerem repozytorium.
AUTHENTICATION_ERROR Uwierzytelnianie nie powiodło się z powodu nieprawidłowych danych logowania.
AUTHORIZATION_ERROR Konto usługi nie ma autoryzacji dla repozytorium.
SERVER_ERROR Błąd serwera repozytorium.
QUOTA_EXCEEDED Przekroczono limit.
SERVICE_UNAVAILABLE Serwer jest tymczasowo niedostępny.
CLIENT_ERROR Błąd związany z klientem, na przykład nieprawidłowe żądanie z oprogramowania sprzęgającego do serwera repozytorium.

Item.ItemType

Wartości w polu enum
UNSPECIFIED
CONTENT_ITEM Element, który jest indeksowany wyłącznie w celu wyświetlania informacji. Nie można odwoływać się do tych elementów w polach containerName ani inheritAclFrom.
CONTAINER_ITEM Indeksowany element, którego celem jest dostarczanie innych elementów za pomocą list kontroli dostępu i/lub zawieranie innych elementów.
VIRTUAL_CONTAINER_ITEM Element, który nie jest indeksowany, ale ma to samo przeznaczenie co CONTAINER_ITEM.

Metody

delete

Usuwa Item resource w przypadku określonej nazwy zasobu.

deleteQueueItems

Usuwa wszystkie elementy kolejki.

get

Pobiera wartość Item resource według nazwy elementu.

index

Aktualizuje listę kontroli dostępu (ACL) usługi Item, metadane i treść.

list

Wyświetla wszystkie elementy Item resources lub ich podzbiór.

poll

Wyszukuje niezarezerwowane elementy z kolejki indeksowania i oznacza zestaw jako zarezerwowany, zaczynając od elementów, które mają najstarszą sygnaturę czasową od elementu ItemStatus o najwyższym priorytecie.

push

Umieszcza element w kolejce w celu późniejszego odpytywania i aktualizowania.

unreserve

Anuluje rezerwację wszystkich elementów w kolejce, przez co wszystkie kwalifikują się do odpytywania.

upload

Tworzy sesję przesyłania, aby przesłać treść elementu.