class IndexingDatasourcesItems extends Resource (View source)

The "items" collection of methods.

Typical usage is:

 $cloudsearchService = new Google\Service\CloudSearch(...);
 $items = $cloudsearchService->indexing_datasources_items;

Methods

delete(string $name, array $optParams = [])

Deletes Item resource for the specified resource name. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.delete)

deleteQueueItems(string $name, DeleteQueueItemsRequest $postBody, array $optParams = [])

Deletes all items in a queue. This method is useful for deleting stale items.

get(string $name, array $optParams = [])

Gets Item resource by item name. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.get)

index(string $name, IndexItemRequest $postBody, array $optParams = [])

Updates Item ACL, metadata, and content. It will insert the Item if it does not exist. This method does not support partial updates. Fields with no provided values are cleared out in the Cloud Search index. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.index)

listIndexingDatasourcesItems(string $name, array $optParams = [])

Lists all or a subset of Item resources. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.listIndexingDatasourcesItems)

poll(string $name, PollItemsRequest $postBody, array $optParams = [])

Polls for unreserved items from the indexing queue and marks a set as reserved, starting with items that have the oldest timestamp from the highest priority ItemStatus. The priority order is as follows: ERROR MODIFIED NEW_ITEM ACCEPTED Reserving items ensures that polling from other threads cannot create overlapping sets. After handling the reserved items, the client should put items back into the unreserved state, either by calling index, or by calling push with the type REQUEUE. Items automatically become available (unreserved) after 4 hours even if no update or push method is called. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.poll)

push(string $name, PushItemRequest $postBody, array $optParams = [])

Pushes an item onto a queue for later polling and updating. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.push)

unreserve(string $name, UnreserveItemsRequest $postBody, array $optParams = [])

Unreserves all items from a queue, making them all eligible to be polled.

upload(string $name, StartUploadItemRequest $postBody, array $optParams = [])

Creates an upload session for uploading item content. For items smaller than 100 KB, it's easier to embed the content inline within an index request. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.upload)

Details

Operation delete(string $name, array $optParams = [])

Deletes Item resource for the specified resource name. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.delete)

Parameters

string $name

Required. The name of the item to delete. Format: datasources/{source_id}/items/{item_id}

array $optParams

Optional parameters.

Return Value

Operation

Exceptions

Exception

Operation deleteQueueItems(string $name, DeleteQueueItemsRequest $postBody, array $optParams = [])

Deletes all items in a queue. This method is useful for deleting stale items.

This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.deleteQueueItems)

Parameters

string $name

The name of the Data Source to delete items in a queue. Format: datasources/{source_id}

DeleteQueueItemsRequest $postBody
array $optParams

Optional parameters.

Return Value

Operation

Exceptions

Exception

Item get(string $name, array $optParams = [])

Gets Item resource by item name. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.get)

Parameters

string $name

The name of the item to get info. Format: datasources/{source_id}/items/{item_id}

array $optParams

Optional parameters.

Return Value

Item

Exceptions

Exception

Operation index(string $name, IndexItemRequest $postBody, array $optParams = [])

Updates Item ACL, metadata, and content. It will insert the Item if it does not exist. This method does not support partial updates. Fields with no provided values are cleared out in the Cloud Search index. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.index)

Parameters

string $name

The name of the Item. Format: datasources/{source_id}/items/{item_id} This is a required field. The maximum length is 1536 characters.

IndexItemRequest $postBody
array $optParams

Optional parameters.

Return Value

Operation

Exceptions

Exception

ListItemsResponse listIndexingDatasourcesItems(string $name, array $optParams = [])

Lists all or a subset of Item resources. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.listIndexingDatasourcesItems)

Parameters

string $name

The name of the Data Source to list Items. Format: datasources/{source_id}

array $optParams

Optional parameters.

Return Value

ListItemsResponse

Exceptions

Exception

PollItemsResponse poll(string $name, PollItemsRequest $postBody, array $optParams = [])

Polls for unreserved items from the indexing queue and marks a set as reserved, starting with items that have the oldest timestamp from the highest priority ItemStatus. The priority order is as follows: ERROR MODIFIED NEW_ITEM ACCEPTED Reserving items ensures that polling from other threads cannot create overlapping sets. After handling the reserved items, the client should put items back into the unreserved state, either by calling index, or by calling push with the type REQUEUE. Items automatically become available (unreserved) after 4 hours even if no update or push method is called. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.poll)

Parameters

string $name

The name of the Data Source to poll items. Format: datasources/{source_id}

PollItemsRequest $postBody
array $optParams

Optional parameters.

Return Value

PollItemsResponse

Exceptions

Exception

Item push(string $name, PushItemRequest $postBody, array $optParams = [])

Pushes an item onto a queue for later polling and updating. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.push)

Parameters

string $name

The name of the item to push into the indexing queue. Format: datasources/{source_id}/items/{ID} This is a required field. The maximum length is 1536 characters.

PushItemRequest $postBody
array $optParams

Optional parameters.

Return Value

Item

Exceptions

Exception

Operation unreserve(string $name, UnreserveItemsRequest $postBody, array $optParams = [])

Unreserves all items from a queue, making them all eligible to be polled.

This method is useful for resetting the indexing queue after a connector has been restarted. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.unreserve)

Parameters

string $name

The name of the Data Source to unreserve all items. Format: datasources/{source_id}

UnreserveItemsRequest $postBody
array $optParams

Optional parameters.

Return Value

Operation

Exceptions

Exception

UploadItemRef upload(string $name, StartUploadItemRequest $postBody, array $optParams = [])

Creates an upload session for uploading item content. For items smaller than 100 KB, it's easier to embed the content inline within an index request. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. (items.upload)

Parameters

string $name

The name of the Item to start a resumable upload. Format: datasources/{source_id}/items/{item_id}. The maximum length is 1536 bytes.

StartUploadItemRequest $postBody
array $optParams

Optional parameters.

Return Value

UploadItemRef

Exceptions

Exception