A locator for text. Indicates a particular part of the text of a
request or of an object referenced in the request. For example,
suppose the request field text
contains: text: "The quick brown
fox jumps over the lazy dog." Then the locator: source: "text"
start_position { line: 1 column: 17 } end_position { line: 1 column:
19 } refers to the part of the text: "fox".
.. attribute:: source
The source of the text. The source may be a field in the request, in which case its format is the format of the google.rpc.BadRequest.FieldViolation.field field in https://cloud.google.com/apis/design/errors#error_details. It may also be be a source other than the request field (e.g. a macro definition referenced in the text of the query), in which case this is the name of the source (e.g. the macro name).
The position of the last byte within the text.
When nested_locator
is set, this field gives the reason
for the nesting. Usually, the reason is a macro invocation. In
that case, the macro name (including the leading '@') signals
the location of the macro call in the text and a macro
argument name (including the leading '$') signals the location
of the macro argument inside the macro body that got
substituted away.
Classes
Position
The position of a byte within the text. .. attribute:: line
The line, starting with 1, where the byte is positioned.