Page
class Page implements IteratorAggregate
A Page object wraps an API list method response and provides methods to retrieve additional pages using the page token.
Constants
| FINAL_PAGE_TOKEN |
|
Methods
Page constructor.
Returns true if there are more pages that can be retrieved from the API.
Returns the next page token from the response.
Retrieves the next Page object using the next page token.
Return the number of elements in the response.
Return an iterator over the elements in the response.
Return an iterator over Page objects, beginning with this object.
Gets the request object used to generate the Page.
Gets the API response object.
Returns a collection of elements with a fixed size set by the collectionSize parameter. The collection will only contain fewer than collectionSize elements if there are no more pages to be retrieved from the server.
Details
at line 64
__construct(Call $call, array $options, callable $callable, PageStreamingDescriptor $pageStreamingDescriptor, Message $response)
Page constructor.
at line 87
bool
hasNextPage()
Returns true if there are more pages that can be retrieved from the API.
at line 97
string
getNextPageToken()
Returns the next page token from the response.
at line 111
Page
getNextPage(int|null $pageSize = null)
Retrieves the next Page object using the next page token.
at line 157
int
getPageElementCount()
Return the number of elements in the response.
at line 168
Generator
getIterator()
Return an iterator over the elements in the response.
at line 183
Page[]
iteratePages()
Return an iterator over Page objects, beginning with this object.
Additional Page objects are retrieved lazily via API calls until all elements have been retrieved.
at line 198
Message
getRequestObject()
Gets the request object used to generate the Page.
at line 208
Message
getResponseObject()
Gets the API response object.
at line 229
FixedSizeCollection
expandToFixedSizeCollection($collectionSize)
Returns a collection of elements with a fixed size set by the collectionSize parameter. The collection will only contain fewer than collectionSize elements if there are no more pages to be retrieved from the server.
NOTE: it is an error to call this method if an optional parameter to set the page size is not supported or has not been set in the API call that was used to create this page. It is also an error if the collectionSize parameter is less than the page size that has been set.