Also encountered this. Not all the documentation has been updated yet, but they have published a migration guide:
https://googleapis.dev/python/translation/latest/UPGRADING.html
You could replace parent
with "projects/<PROJECT_ID>/locations/<LOCATION>"
or define
def location_path(project_id, location):
# might as well use an f-string, the new library supports python >=3.6
return f"projects/{project_id}/locations/{location}"
and change client.location_path
to location_path
if this is something you use in many locations.
There are more sweeping changes, too. They now prefer you to pass a dictionary called request
to the API methods, although the old way is still accepted. Thus, your code might look like this:
from google.cloud import translate_v3 as translate
client = translate.TranslationServiceClient(credentials=credentials)
response = client.translate_text(
request={
"parent": "projects/my-location/locations/global",
"target_language_code": target_language_code,
"contents": [text],
}
)
Now, you might well ask 'how will I know what to put in that request dictionary?'. It looks as though the library comes with type annotations for the dictionaries appropriate for each method: https://googleapis.dev/python/translation/latest/translate_v3/types.html
For example, I read in your comment on another answer that you have had trouble with the detect_language
method. The method signature indicates that if you use keyword arguments, content
should be a valid one, so I don't know why that fails - maybe it's a bug.
However, if instead you use a request
dictionary, that should look like this. You'll see that the keys don't appear to correspond exactly to the method signature keywords (although content
is one of them).
This code would work:
response = client.detect_language({
"parent": "projects/my-location/locations/global",
"content": "Tá Gaeilge Agam, ach tá mé i mo chonai i Sasana",
})
lang = response.languages[0].language_code
(the return type is somewhat convoluted, as you can see)