Media Upload Object


One queued photo change on a Google Business Profile location: either an addition or a removal.

Photo changes are queued and applied gradually rather than immediately, because Google accepts only about 10 edits per minute per Business Profile.

Anything you can read here is either still waiting to be applied or has failed. A change that succeeded leaves nothing behind, so an empty list means the queue finished and everything worked. See state.

Properties
attemptsintegerRead-only

How many times this change has been attempted.


batchIdstringRead-onlyformat GUID

Groups the changes queued by one Bulk Create Media Uploads call. Useful for troubleshooting, since one save can produce more than one batch.


categorystring

createdDatestringRead-onlyformat date-time

Date and time the change was queued.


failureMediaUploadFailureRead-only

Why this change failed. Present only when state is FAILED.


formatstring

idstringRead-onlyformat GUID

Queued change ID.


locationIdstringimmutableminLength 1maxLength 255

ID of the location this change applies to. This is Google's location identifier.


mediaKeystringmaxLength 255

Google's identifier for the photo to remove. Removals only.


operationstring

revisionstringRead-only

Revision number, incremented on every update.


sequenceintegerRead-only

Position in the order the queue applies changes, assigned by the server.

Every removal comes before every addition, because Google rejects new photos on a profile that's already at its limit, so the old ones have to go first. Additions then follow as logo, cover, and gallery in the order given.


slotKeystringmaxLength 255

Your own key for this photo: logo, cover, or photo:<id>.

Set it to something stable and meaningful to you. It's how a failure is matched back to the photo that caused it, and it's part of what makes a repeated submission a duplicate rather than a second change.


sourceUrlstringmaxLength 2048

Publicly reachable URL Google fetches the image from. Additions only.

Keep it reachable well beyond the upload itself. A failure report renders this URL as a thumbnail, possibly weeks later.


statestringRead-only

updatedDatestringRead-onlyformat date-time

Date and time the change was last updated.

Did this help?