Documentation of API

[audas]

Is there going to be any documentation for this PHP API library?

There does not appear to be anything functional or useable and I am wondering if this will ever change.

For example getStartTime()->serializeToJsonString() ?

Where would someone find this ? Are there alternatives ?

Its well known that Googles Docs are worse than any other system for almost any API there is, bar none - so was just wondering if Google or anyone would be addressing this ?

[danoscarmike]

Hi @audas thanks for dropping by. Can you tell us a little more? Which API or library are you trying to use?

[audas]

Google Speech To Text.

There is literally no documentation on V1 on the API for things like serializeToJsonString()

ALSO

Authorizing in V1 and then using cloud storage bucket for processing.

Honestly - just include examples of authorization instead of links to external sites which offer absolutely no insight into how to accomplish the process.

Whats worse is, as mentioned, using the storage bucket required a DIFFERENT form of authorization.

for storage we need to use this (the alternatives failed)

    $storage = new StorageClient([
        'keyFilePath' => 'client_secret.json',
        'projectId' => 'projectID'
    ]);

However for V1 speech to text this was the only method which worked. These are the SAME credentials

$credentials=json_decode($results['json_files'], true);
$client = new SpeechClient(['credentials' => $credentials]);

I was forced to write the credentials from the database to a file in order for Storage Client to work.

The process of AUTHORIZATION is the most critical aspect of using these libraries and it is literally NOT addressed at all.

Thanks.

[saranshdhingra]

Hi @audas Apologies for the late response on this issue.

I'm not sure when was it published, but the documentation and samples for the Speech to text library can be found here.

In some samples I can see reference to serializeToJsonString calls as well.

As far as credentials are concerned. There are a few clients which support the credentials config param while, some which currently use the keyFile and keyFilePath parameters. This is mentioned in AUTHENTICATION.md for now.

We are in the process of unifying these client options for all the clients. But until that happens, please use the mentioned AUTHENTICATION.md as a reference.

Closing this issue for now, but please feel free to reopen this if you have any more questions.

Thanks.

[audas]

Ok, so 3 years later - thanks. Had to literally learn new languages and ditch PHP because this was so bad. Will check out the update....