class_docstr: Use the Google Cloud connection to interact with Google Cloud Storage.
class_docstr_tok: ["Use","the","Google","Cloud","connection","to","interact","with","Google","Cloud","Storage","."]
docstr: List all objects from the bucket with the given string prefix that were updated in the time range.
  
  :param bucket_name: bucket name
  :param timespan_start: will return objects that were updated at or after this datetime (UTC)
  :param timespan_end: will return objects that were updated before this datetime (UTC)
  :param versions: if true, list all versions of the objects
  :param max_results: max count of items to return in a single page of responses
  :param prefix: prefix string which filters objects whose name begin with
      this prefix
  :param delimiter: (Deprecated) filters objects based on the delimiter (for e.g '.csv')
  :param match_glob: (Optional) filters objects based on the glob pattern given by the string
      (e.g, ``'**/*/.json'``).
  :return: a stream of object names matching the filtering criteria
docstr_tok: ["List","all","objects","from","the","bucket","with","the","given","string","prefix","that","were","updated","in","the","time","range",".",":","param","bucket_name",":","bucket","name",":","param","timespan_start",":","will","return","objects","that","were","updated","at","or","after","this","datetime","(","UTC",")",":","param","timespan_end",":","will","return","objects","that","were","updated","before","this","datetime","(","UTC",")",":","param","versions",":","if","true",",","list","all","versions","of","the","objects",":","param","max_results",":","max","count","of","items","to","return","in","a","single","page","of","responses",":","param","prefix",":","prefix","string","which","filters","objects","whose","name","begin","with","this","prefix",":","param","delimiter",":","(","Deprecated",")","filters","objects","based","on","the","delimiter","(","for","e.g","'.csv","'",")",":","param","match_glob",":","(","Optional",")","filters","objects","based","on","the","glob","pattern","given","by","the","string","(","e.g",",","``","'","*","*","\/","*","\/.json","'","``",")",".",":","return",":","a","stream","of","object","names","matching","the","filtering","criteria"]
code: def list_by_timespan(
      self,
      bucket_name: str,
      timespan_start: datetime,
      timespan_end: datetime,
      versions: bool | None = None,
      max_results: int | None = None,
      prefix: str | None = None,
      delimiter: str | None = None,
      match_glob: str | None = None,
  ) -> List[str]:
      """
      List all objects from the bucket with the given string prefix that were updated in the time range.
  
      :param bucket_name: bucket name
      :param timespan_start: will return objects that were updated at or after this datetime (UTC)
      :param timespan_end: will return objects that were updated before this datetime (UTC)
      :param versions: if true, list all versions of the objects
      :param max_results: max count of items to return in a single page of responses
      :param prefix: prefix string which filters objects whose name begin with
          this prefix
      :param delimiter: (Deprecated) filters objects based on the delimiter (for e.g '.csv')
      :param match_glob: (Optional) filters objects based on the glob pattern given by the string
          (e.g, ``'**/*/.json'``).
      :return: a stream of object names matching the filtering criteria
      """
      client = self.get_conn()
      bucket = client.bucket(bucket_name)
  
      ids = []
      page_token = None
  
      while True:
          if match_glob:
              blobs = self._list_blobs_with_match_glob(
                  bucket=bucket,
                  client=client,
                  match_glob=match_glob,
                  max_results=max_results,
                  page_token=page_token,
                  path=bucket.path + "/o",
                  prefix=prefix,
                  versions=versions,
              )
          else:
              blobs = bucket.list_blobs(
                  max_results=max_results,
                  page_token=page_token,
                  prefix=prefix,
                  delimiter=delimiter,
                  versions=versions,
              )
  
          blob_names = [
              blob.name
              for blob in blobs
              if timespan_start
              <= blob.updated.replace(tzinfo=timezone.utc)
              < timespan_end
          ]
  
          if blobs.prefixes:
              ids.extend(blobs.prefixes)
          else:
              ids.extend(blob_names)
  
          page_token = blobs.next_page_token
          if page_token is None:
              # empty next page token
              break
      return ids
  
imports: from __future__ import annotations
  import functools
  import gzip
  import json
  import os
  import shutil
  import time
  import warnings
  from contextlib import contextmanager
  from functools import partial
  from io import BytesIO
  from tempfile import NamedTemporaryFile
  from typing import IO, TYPE_CHECKING, Any, Callable, Generator, Sequence, TypeVar, cast, overload
  from urllib.parse import urlsplit
  from gcloud.aio.storage import Storage
  from google.api_core.exceptions import GoogleAPICallError, NotFound
  from google.cloud import storage
  from google.cloud.exceptions import GoogleCloudError
  from google.cloud.storage.retry import DEFAULT_RETRY
  from requests import Session
  from airflow.exceptions import AirflowException, AirflowProviderDeprecationWarning
  from airflow.providers.google.cloud.utils.helpers import normalize_directory_path
  from airflow.providers.google.common.consts import CLIENT_INFO
  from airflow.providers.google.common.hooks.base_google import GoogleBaseAsyncHook, GoogleBaseHook
  from airflow.typing_compat import ParamSpec
  from airflow.utils import timezone
  from airflow.version import version
label_desc: Use image node_id 23 for calling the GCSHook obj's underlying member method code with example usage: obj.list_by_timespan(bucket_name, timespan_start, timespan_end, versions, max_results, prefix, delimiter, match_glob) and returns: ids