Class ListDocumentsPager (0.13.12)

Version latest

• 0.13.12 (latest)
• 0.13.11
• 0.12.3
• 0.11.14
• 0.10.0
• 0.9.1
• 0.8.1
• 0.7.0
• 0.6.0
• 0.5.0
• 0.4.1
• 0.3.1
• 0.2.1
• 0.1.1

ListDocumentsPager(
    method: typing.Callable[
        [...],
        google.cloud.discoveryengine_v1alpha.types.document_service.ListDocumentsResponse,
    ],
    request: google.cloud.discoveryengine_v1alpha.types.document_service.ListDocumentsRequest,
    response: google.cloud.discoveryengine_v1alpha.types.document_service.ListDocumentsResponse,
    *,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.Retry,
            google.api_core.gapic_v1.method._MethodDefault,
        ]
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, typing.Union[str, bytes]]] = ()
)

A pager for iterating through list_documents requests.

This class thinly wraps an initial ListDocumentsResponse object, and provides an __iter__ method to iterate through its documents field.

If there are more pages, the __iter__ method will make additional ListDocuments requests and continue to iterate through the documents field on the corresponding responses.

All the usual ListDocumentsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

Methods

ListDocumentsPager

ListDocumentsPager(
    method: typing.Callable[
        [...],
        google.cloud.discoveryengine_v1alpha.types.document_service.ListDocumentsResponse,
    ],
    request: google.cloud.discoveryengine_v1alpha.types.document_service.ListDocumentsRequest,
    response: google.cloud.discoveryengine_v1alpha.types.document_service.ListDocumentsResponse,
    *,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.Retry,
            google.api_core.gapic_v1.method._MethodDefault,
        ]
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, typing.Union[str, bytes]]] = ()
)

Instantiate the pager.

Parameters
Name	Description
method	Callable The method that was originally called, and which instantiated this pager.
request	google.cloud.discoveryengine_v1alpha.types.ListDocumentsRequest The initial request object.
response	google.cloud.discoveryengine_v1alpha.types.ListDocumentsResponse The initial response object.
retry	google.api_core.retry.Retry Designation of what errors, if any, should be retried.
timeout	float The timeout for this request.
metadata	Sequence[Tuple[str, Union[str, bytes]]] Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type str, but for metadata keys ending with the suffix -bin, the corresponding values must be of type bytes.