Unable to access private APIs

There is no possibility to use earthengine api with default behavior (static_discovery=True), because corresponded file is missed in discovery_cache.

In addition this changes broke earthengine-api, see issues/157

[busunkim96]

Hi,

I think from the perspective of this library things are working as intended. static_discovery=True can only be used with APIs listed in the public directory of Google APIs: https://www.googleapis.com/discovery/v1/apis.

If an API is outside that list (API is private and/or not listed in the directory), there are two options:

1. Use discovery.build_from_document() with a copy of a discovery doc JSON for the API.

It looks like https://github.com/google/earthengine-api/blob/114dcad4bdd2edd7cf604c39e33019baab15436d/python/ee/_cloud_api_utils.py#L156-L179 does this, but only for tests.

Pros:

• Library will not change unexpectedly.
• No dependency on the live discovery document being available.

Cons:

• Need to update the JSON file manually.

2. Use discovery.build() and pass both discoveryServiceUrl and static_discovery=False.

from googleapiclient import discovery

client = discovery.build(
    "commentanalyzer",
    "v1alpha1",
    discoveryServiceUrl="https://commentanalyzer.googleapis.com/$discovery/rest?version=v1alpha1",
    static_discovery=False,
)

This results in behavior equivalent to 1.x of this library.

Pros:

• Library always matches the latest version of the API.

Cons:

• If the discovery doc is unavailable for some period of time, you cannot use the Python library.
• The discovery doc may change in unexpected ways, resulting in different results from running the same code with the same dependencies multiple times.

@parthea Would you mind adding some information to the docs clarifying which APIs are available with static_discovery=True?

[busunkim96]

Hi @Ark-kun,

Please see https://github.com/googleapis/google-api-python-client/issues/1225#issuecomment-791045487.

Right now, you would do something like this to call a private API:

from googleapiclient import discovery

client = discovery.build(
    "myapi",
    "v1alpha1",
    discoveryServiceUrl="https://myapi.googleapis.com/$discovery/rest?version=v1alpha1",
    static_discovery=False,
)

@parthea and I were discussing automatically setting static_discovery=False if discoveryServiceUrl is passed. With that change folks would do something like this:

from googleapiclient import discovery

client = discovery.build(
    "myapi",
    "v1alpha1",
    discoveryServiceUrl="https://myapi.googleapis.com/$discovery/rest?version=v1alpha1",
)