Function: json.decode

Decodes given JSON bytes (assuming UTF-8), or a string, into an object.

If the input is bytes, it is first converted to a string, as if by callingtext.decode(data, 'UTF-8').

Arguments

Arguments
data

bytes|string

The input to be decoded.

Returns

The decoded object.

Raised exceptions

Exceptions
ValueErrorIf given data is not a valid JSON object.

Examples

For more information, seeReturning bytes.

# Decode Base64-encoded string to bytes, then decode bytes to object-init:assign:-project:'${sys.get_env("GOOGLE_CLOUD_PROJECT_ID")}'-subscription:SUBSCRIPTION_ID-pullMessage:# pulls Pub/Sub messagecall:googleapis.pubsub.v1.projects.subscriptions.pullargs:subscription:'${"projects/"+project+"/subscriptions/"+subscription}'body:maxMessages:1result:m-outputMessage:return:'${json.decode(base64.decode(m.receivedMessages[0].message.data))}'

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.