googleapis / google-api-python-client

🐍 The official Python client library for Google's discovery based APIs.
https://googleapis.github.io/google-api-python-client/docs/
Apache License 2.0
7.77k stars 2.41k forks source link

Support visibility labels in discovery requests #935

Open Capstan opened 4 years ago

Capstan commented 4 years ago

If I am part of an early access program, then I might have to specify a specific labels URL parameter in order to get access to pre-release features or APIs. Today, if I want to do this, I have to do something like

my_client = apiclient.discovery.build(
    'someapi',
    'v1alpha1',
    discoveryServiceUrl=apiclient.discovery.V2_DISCOVERY_URI + '&labels=TRUSTED_TESTER_FEATURE',
    developerKey=my_developer_key)

It would be appreciated if labels [sic] were a parameter to build so I don't have to think about manual changes to the default discovery service URL logic.

busunkim96 commented 4 years ago

Hi @Capstan,

Is 'labels' the standard way for APIs provide early access to new features? I'm having a bit of trouble finding documentation,

Capstan commented 4 years ago

I sent you a pointer in email to internal documentation. Sadly, there doesn't be any public docs, but that might just be because early adopters are often NDAed and the docs remain private.

Apparently, there are alternatives documented in the internally-visible-only section of https://cloud.google.com/apis/docs/system-parameters, but I haven't tried them yet.

parthea commented 3 years ago

Hi @Capstan,

I'm going to close off this issue due to inactivity. If this feature is still desired, please re-open this issue and we can take a look.

Capstan commented 3 years ago

I would love to leave a BroccoliMan quote. If y'all aren't interested in your early access users, then /shrug.

parthea commented 3 years ago

Hi @Capstan, I closed a lot of issues yesterday as part of an effort to cleanup the backlog as some issues were obsolete. I'll re-open this issue and see if we can move it forward. Are you by any chance interested in submitting a PR for the feature?