Found new managed modules references#1187
Merged
unmultimedio merged 1 commit intomainfrom Mar 30, 2026
Merged
Conversation
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
| }, | ||
| { | ||
| "name": "208f19890d8e0a4a5bc772584246c973ff57f6c1", | ||
| "digest": "0e71d88a4ce59813b8b04db0c4097b15932c6b3e2e9dbd0df9f6969046bb378fb54b4266df23ab142b88aa9359e0db3f4f707ab39ef7db58376e4c8e5b83063f" |
There was a problem hiding this comment.
[Posted at 2026-03-30T12:19:23Z]
$ casdiff a7cd05f10e0e4cc27d9fa489dbfcaefc9713d752 208f19890d8e0a4a5bc772584246c973ff57f6c1 --format=markdown17 files changed: 0 removed, 0 renamed, 0 added, 17 changed content
Files changed content:
google/type/calendar_period.proto:
--- shake256:166440440c1bd594766f6a92c2c1cf2aa1f58d348e1f7febcbd0417f3057a1bcc750c157cd0655da714ecc42c23a1bcf27af95636e09cc27e7917569b76936e9 google/type/calendar_period.proto
+++ shake256:128d37470765dab5fc26bf57c151d6c4bf5ea752a5af02452c64895596d2a2631b3368369a9d8258dcd20cdf2d10288e8e8a29350282114856e8e2dbe22c3f6c google/type/calendar_period.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
google/type/color.proto:
--- shake256:67ead0f2a71a03464e81a0655a5ddb0eea3008cfeb06c92c7350c3fac147e72a18457ee746b2fa501bafe165c45e78dadc7cf54536b3b2a8840199658a200dcb google/type/color.proto
+++ shake256:aa0c1dab8fcf0b21391d2a18de2f1ec9357d4674108543c6961d769a256e83be9e32d7efeaf1195e3dd364c8491007a630dc41186a44dd7be7ce6a52a16378fa google/type/color.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -18,7 +18,6 @@
import "google/protobuf/wrappers.proto";
-option cc_enable_arenas = true;
option go_package = "google.golang.org/genproto/googleapis/type/color;color";
option java_multiple_files = true;
option java_outer_classname = "ColorProto";
@@ -26,22 +25,22 @@
option objc_class_prefix = "GTP";
// Represents a color in the RGBA color space. This representation is designed
-// for simplicity of conversion to/from color representations in various
+// for simplicity of conversion to and from color representations in various
// languages over compactness. For example, the fields of this representation
// can be trivially provided to the constructor of `java.awt.Color` in Java; it
// can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha`
// method in iOS; and, with just a little work, it can be easily formatted into
// a CSS `rgba()` string in JavaScript.
//
-// This reference page doesn't carry information about the absolute color
-// space
-// that should be used to interpret the RGB value (e.g. sRGB, Adobe RGB,
-// DCI-P3, BT.2020, etc.). By default, applications should assume the sRGB color
+// This reference page doesn't have information about the absolute color
+// space that should be used to interpret the RGB value—for example, sRGB,
+// Adobe RGB,
+// DCI-P3, and BT.2020. By default, applications should assume the sRGB color
// space.
//
-// When color equality needs to be decided, implementations, unless
-// documented otherwise, treat two colors as equal if all their red,
-// green, blue, and alpha values each differ by at most 1e-5.
+// When color equality needs to be decided, implementations, unless documented
+// otherwise, treat two colors as equal if all their red, green, blue, and alpha
+// values each differ by at most `1e-5`.
//
// Example (Java):
//
google/type/date.proto:
--- shake256:269c0230c83092a8ccaa4f0d9ac9d3edafa744feb84ee71a419e5ea3bb3e5a43197ebd0afe96421b8bdd6af4db3e0508854c3fa09d2b2269318542149428de25 google/type/date.proto
+++ shake256:de8f44efafeb135c513daf4e4637812ac73e955f193fb39a4cce97c9c038f6ba2e2e0af6a6dfdfad283fba319ed91a8356b4717067068725c1f48b2b07a9984e google/type/date.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@
package google.type;
-option cc_enable_arenas = true;
option go_package = "google.golang.org/genproto/googleapis/type/date;date";
option java_multiple_files = true;
option java_outer_classname = "DateProto";
@@ -28,14 +27,17 @@
// date is relative to the Gregorian Calendar. This can represent one of the
// following:
//
-// * A full date, with non-zero year, month, and day values
-// * A month and day value, with a zero year, such as an anniversary
-// * A year on its own, with zero month and day values
-// * A year and month value, with a zero day, such as a credit card expiration
-// date
+// * A full date, with non-zero year, month, and day values.
+// * A month and day, with a zero year (for example, an anniversary).
+// * A year on its own, with a zero month and a zero day.
+// * A year and month, with a zero day (for example, a credit card expiration
+// date).
//
-// Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and
-// `google.protobuf.Timestamp`.
+// Related types:
+//
+// * [google.type.TimeOfDay][google.type.TimeOfDay]
+// * [google.type.DateTime][google.type.DateTime]
+// * [google.protobuf.Timestamp][google.protobuf.Timestamp]
message Date {
// Year of the date. Must be from 1 to 9999, or 0 to specify a date without
// a year.
google/type/datetime.proto:
--- shake256:cc278b6cb6fffadb8f4e85bdc30084c39ebd72245eed3d1444845d797b8f56edaf442f54990dbae7d7d907355844e9a0588fd63b4fe358b1c2b82ada4e68d9b4 google/type/datetime.proto
+++ shake256:278812ecc9dedc26681df44bb528eeb75b8e20e374493ec9bf6c2ec2954558bc30057b0826df692fadd0764274fda7044a1e7aa51a5a8caefd17dfab8b31eaa3 google/type/datetime.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -18,7 +18,6 @@
import "google/protobuf/duration.proto";
-option cc_enable_arenas = true;
option go_package = "google.golang.org/genproto/googleapis/type/datetime;datetime";
option java_multiple_files = true;
option java_outer_classname = "DateTimeProto";
@@ -38,8 +37,8 @@
//
// The date is relative to the Proleptic Gregorian Calendar.
//
-// If year is 0, the DateTime is considered not to have a specific year. month
-// and day must have valid, non-zero values.
+// If year, month, or day are 0, the DateTime is considered not to have a
+// specific year, month, or day respectively.
//
// This type may also be used to represent a physical time if all the date and
// time fields are set and either case of the `time_offset` oneof is set.
@@ -54,27 +53,28 @@
// datetime without a year.
int32 year = 1;
- // Required. Month of year. Must be from 1 to 12.
+ // Optional. Month of year. Must be from 1 to 12, or 0 if specifying a
+ // datetime without a month.
int32 month = 2;
- // Required. Day of month. Must be from 1 to 31 and valid for the year and
- // month.
+ // Optional. Day of month. Must be from 1 to 31 and valid for the year and
+ // month, or 0 if specifying a datetime without a day.
int32 day = 3;
- // Required. Hours of day in 24 hour format. Should be from 0 to 23. An API
- // may choose to allow the value "24:00:00" for scenarios like business
- // closing time.
+ // Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults
+ // to 0 (midnight). An API may choose to allow the value "24:00:00" for
+ // scenarios like business closing time.
int32 hours = 4;
- // Required. Minutes of hour of day. Must be from 0 to 59.
+ // Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
int32 minutes = 5;
- // Required. Seconds of minutes of the time. Must normally be from 0 to 59. An
- // API may allow the value 60 if it allows leap-seconds.
+ // Optional. Seconds of minutes of the time. Must normally be from 0 to 59,
+ // defaults to 0. An API may allow the value 60 if it allows leap-seconds.
int32 seconds = 6;
- // Required. Fractions of seconds in nanoseconds. Must be from 0 to
- // 999,999,999.
+ // Optional. Fractions of seconds in nanoseconds. Must be from 0 to
+ // 999,999,999, defaults to 0.
int32 nanos = 7;
// Optional. Specifies either the UTC offset or the time zone of the DateTime.
@@ -96,9 +96,9 @@
// Represents a time zone from the
// [IANA Time Zone Database](https://www.iana.org/time-zones).
message TimeZone {
- // IANA Time Zone Database time zone, e.g. "America/New_York".
+ // IANA Time Zone Database time zone. For example "America/New_York".
string id = 1;
- // Optional. IANA Time Zone Database version number, e.g. "2019a".
+ // Optional. IANA Time Zone Database version number. For example "2019a".
string version = 2;
}
google/type/dayofweek.proto:
--- shake256:18bbe6c9926632870a902c8b13cf7a81ee7e488ddb80e0de77eb65adde31cc4e61c0235e9711b4ab2db92a62bdae9c9361edad92315dde6fb85b599212037b8c google/type/dayofweek.proto
+++ shake256:6042fe90cc38a16dfe26de4cfa4c14f0d98136f55fbab8c293140afe4dfb35174e8f9ccadb1671bac72860a6b8293842de3aa39fe8f07c1effc9088a1b41f64a google/type/dayofweek.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
google/type/decimal.proto:
--- shake256:dbdb8bca1e0d4652556b0f725cb8b75f1d1ebcb3214ec0b7dde2c0fbbdea9d8327e5e13c9c9bdc7e1c45b1c09f370b3c430172de5cb8595dee6982ae12519c37 google/type/decimal.proto
+++ shake256:55ff3b900338573d1e70472308caa795dd24a4ec6c6d96119ad352cad1257627e12ad937a0f81d18d667ad362779d8b4f8cd08cbb0b21fbf95c6ef36966a6425 google/type/decimal.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@
package google.type;
-option cc_enable_arenas = true;
option go_package = "google.golang.org/genproto/googleapis/type/decimal;decimal";
option java_multiple_files = true;
option java_outer_classname = "DecimalProto";
@@ -24,19 +23,17 @@
option objc_class_prefix = "GTP";
// A representation of a decimal value, such as 2.5. Clients may convert values
-// into language-native decimal formats, such as Java's [BigDecimal][] or
-// Python's [decimal.Decimal][].
-//
-// [BigDecimal]:
-// https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/math/BigDecimal.html
-// [decimal.Decimal]: https://docs.python.org/3/library/decimal.html
+// into language-native decimal formats, such as Java's
+// [BigDecimal](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/math/BigDecimal.html)
+// or Python's
+// [decimal.Decimal](https://docs.python.org/3/library/decimal.html).
message Decimal {
// The decimal value, as a string.
//
// The string representation consists of an optional sign, `+` (`U+002B`)
// or `-` (`U+002D`), followed by a sequence of zero or more decimal digits
// ("the integer"), optionally followed by a fraction, optionally followed
- // by an exponent.
+ // by an exponent. An empty string **should** be interpreted as `0`.
//
// The fraction consists of a decimal point followed by zero or more decimal
// digits. The string must contain at least one digit in either the integer
@@ -50,12 +47,13 @@
//
// - Removing an explicitly-provided `+` sign (`+2.5` -> `2.5`).
// - Replacing a zero-length integer value with `0` (`.5` -> `0.5`).
- // - Coercing the exponent character to lower-case (`2.5E8` -> `2.5e8`).
- // - Removing an explicitly-provided zero exponent (`2.5e0` -> `2.5`).
+ // - Coercing the exponent character to upper-case, with explicit sign
+ // (`2.5e8` -> `2.5E+8`).
+ // - Removing an explicitly-provided zero exponent (`2.5E0` -> `2.5`).
//
// Services **may** perform additional normalization based on its own needs
// and the internal decimal implementation selected, such as shifting the
- // decimal point and exponent value together (example: `2.5e-1` <-> `0.25`).
+ // decimal point and exponent value together (example: `2.5E-1` <-> `0.25`).
// Additionally, services **may** preserve trailing zeroes in the fraction
// to indicate increased precision, but are not required to do so.
//
@@ -67,7 +65,7 @@
// The ENBF grammar is:
//
// DecimalString =
- // [Sign] Significand [Exponent];
+ // '' | [Sign] Significand [Exponent];
//
// Sign = '+' | '-';
//
google/type/expr.proto:
--- shake256:e414090b3a9b2b57164f6d4496085d37ac301277b77d578b4c637d14e76806e958ae1dddc120171ba6622ff8888f8958ec5414ea89ed856ee04a92b4ff6a231d google/type/expr.proto
+++ shake256:1b39d7573ec87f46b6807e73ce7819fc98ea0841bbe05f8d01dc53da9ae2210e522cd21e1d84ba3e5cde89ad2fa3ecab67666dbd59045824fc81bd68833712bc google/type/expr.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
google/type/fraction.proto:
--- shake256:9ee5ea8082fa3866e43f3514444c589ee8bc07d8ba98c9829d5d33a002d8dc7b83a3f17c67fdcbaea1ef4f04104d50fbf4c19ae107024d3ec8f862253a9a2477 google/type/fraction.proto
+++ shake256:f1f010eeb2059793a6f0f51c049f2277b3bc225d3db87384c3adf10954fead96ce09fd2217be3cf69bf87c835010211476f8db77b15b9deb2939d2bf646fe735 google/type/fraction.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
google/type/interval.proto:
--- shake256:7fe215c1c4987ecbfe761c6f8aaea68fc95e7ed311dfa4222cc056cbffbb9cc3cd1662e802fcc9d10e46c3636e7ce7463ff56f5f3fd45596d09d673df39231ae google/type/interval.proto
+++ shake256:c63630d1536d770eee96e63af5a3c00c99321a6826799ac09bcbf70b6f7e68c720f322ad8922d782a4e5d11ff2fdbe52575c8b70c73f82f765c05b067351de8e google/type/interval.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -18,7 +18,6 @@
import "google/protobuf/timestamp.proto";
-option cc_enable_arenas = true;
option go_package = "google.golang.org/genproto/googleapis/type/interval;interval";
option java_multiple_files = true;
option java_outer_classname = "IntervalProto";
google/type/latlng.proto:
--- shake256:4c3c5c425ae8d1c81a3c75e4cdaf803fa73ead53deea4bbb0d1497a987b5a8983dd30d1584b4c1e2d044140a044618afe7eb70fd1ac6a4c920442894ee5be23e google/type/latlng.proto
+++ shake256:5b81ad5a08f9f73d3d5b497d94e0c6c79f4ec6d8cd3a4b5764caf141d49e3ec80215798d6157ea71bd991f45d53ade1b1034b73c60682e335733c951df37beb7 google/type/latlng.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@
package google.type;
-option cc_enable_arenas = true;
option go_package = "google.golang.org/genproto/googleapis/type/latlng;latlng";
option java_multiple_files = true;
option java_outer_classname = "LatLngProto";
@@ -25,9 +24,9 @@
// An object that represents a latitude/longitude pair. This is expressed as a
// pair of doubles to represent degrees latitude and degrees longitude. Unless
-// specified otherwise, this must conform to the
-// <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
-// standard</a>. Values must be within normalized ranges.
+// specified otherwise, this object must conform to the
+// <a href="https://en.wikipedia.org/wiki/World_Geodetic_System#1984_version">
+// WGS84 standard</a>. Values must be within normalized ranges.
message LatLng {
// The latitude in degrees. It must be in the range [-90.0, +90.0].
double latitude = 1;
google/type/localized_text.proto:
--- shake256:3fa2c38707aed3300e70902934a55630bbc40686b1ea24c8b8cca5713add09087c65b6f91a365982d6ef02098a3c852a4196c94dc0c21fba5008b7341eaaad5c google/type/localized_text.proto
+++ shake256:b0725f95892d8d8affa4767b114f0ab81fb087f88af06d42d79c30c1b49a88cba631deeea47223a9ce3df4824c10331e7fdb5935b84184dc472cb62576c5d4df google/type/localized_text.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@
package google.type;
-option cc_enable_arenas = true;
option go_package = "google.golang.org/genproto/googleapis/type/localized_text;localized_text";
option java_multiple_files = true;
option java_outer_classname = "LocalizedTextProto";
@@ -25,7 +24,8 @@
// Localized variant of a text in a particular language.
message LocalizedText {
- // Localized string in the language corresponding to `language_code' below.
+ // Localized string in the language corresponding to
+ // [language_code][google.type.LocalizedText.language_code] below.
string text = 1;
// The text's BCP-47 language code, such as "en-US" or "sr-Latn".
google/type/money.proto:
--- shake256:c296ea64cacbb5f333edf4ac50401026dcdc270e5faa0747636aaef8a37ba3e057c6fe2f7cff6adbce319443867d6dcd6ea175bc2e1583eb5a5117383e70cb6d google/type/money.proto
+++ shake256:ca21403594960fd6dadfcff2bbcfc7957fecd28949f0a8999ad8ccbc154c9b8eb3ffe7f1b36985c046593cac78329d089257cd31d9973a707b4b785452ce72b5 google/type/money.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@
package google.type;
-option cc_enable_arenas = true;
option go_package = "google.golang.org/genproto/googleapis/type/money;money";
option java_multiple_files = true;
option java_outer_classname = "MoneyProto";
google/type/month.proto:
--- shake256:7ba5652d7b0d41b72a02103b3164d247937b176a3c98744a1f345348c67e5a53a5cd673edf57646b7b12fde5afed40f480432bf5a80f24d3fbe32729192828e1 google/type/month.proto
+++ shake256:1d0d55fda72473493457187e72dae7573f78b272a1653b554e02931ad6fa0bfcb4853583637eeda07c08fb697c8584c9d9d5248f84f970b84e9739a86f09026f google/type/month.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
google/type/phone_number.proto:
--- shake256:890e1c545bc37b30f69f2811f0982504c5aae66f73fdd90efc2aabd504fa254177205a944b41b3bb517acb43c8ab73ca8e922139fb1cd0561a0928ee09c73bc3 google/type/phone_number.proto
+++ shake256:169404adb1af66122741f6905e79fd1e4725d796201ca97585d54f06d2d5fa2f72cbbe772081008da559d373e85d27c7ad8b2cbc26be80f04641bef6e8008571 google/type/phone_number.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@
package google.type;
-option cc_enable_arenas = true;
option go_package = "google.golang.org/genproto/googleapis/type/phone_number;phone_number";
option java_multiple_files = true;
option java_outer_classname = "PhoneNumberProto";
@@ -39,13 +38,13 @@
//
// For instance, in Java this would be:
//
-// com.google.type.PhoneNumber wireProto =
-// com.google.type.PhoneNumber.newBuilder().build();
-// com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber =
-// PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ");
-// if (!wireProto.getExtension().isEmpty()) {
-// phoneNumber.setExtension(wireProto.getExtension());
-// }
+// com.google.type.PhoneNumber wireProto =
+// com.google.type.PhoneNumber.newBuilder().build();
+// com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber =
+// PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ");
+// if (!wireProto.getExtension().isEmpty()) {
+// phoneNumber.setExtension(wireProto.getExtension());
+// }
//
// Reference(s):
// - https://github.com/google/libphonenumber
@@ -53,12 +52,13 @@
// An object representing a short code, which is a phone number that is
// typically much shorter than regular phone numbers and can be used to
// address messages in MMS and SMS systems, as well as for abbreviated dialing
- // (e.g. "Text 611 to see how many minutes you have remaining on your plan.").
+ // (For example "Text 611 to see how many minutes you have remaining on your
+ // plan.").
//
// Short codes are restricted to a region and are not internationally
// dialable, which means the same short code can exist in different regions,
// with different usage and pricing, even if those regions share the same
- // country calling code (e.g. US and CA).
+ // country calling code (For example: US and CA).
message ShortCode {
// Required. The BCP-47 region code of the location where calls to this
// short code can be made, such as "US" and "BB".
@@ -68,7 +68,7 @@
string region_code = 1;
// Required. The short code digits, without a leading plus ('+') or country
- // calling code, e.g. "611".
+ // calling code. For example "611".
string number = 2;
}
@@ -79,24 +79,29 @@
// The phone number, represented as a leading plus sign ('+'), followed by a
// phone number that uses a relaxed ITU E.164 format consisting of the
// country calling code (1 to 3 digits) and the subscriber number, with no
- // additional spaces or formatting, e.g.:
+ // additional spaces or formatting. For example:
+ //
// - correct: "+15552220123"
- // - incorrect: "+1 (555) 222-01234 x123".
+ //
+ // - incorrect: "+1 (555) 222-01234 x123"
//
// The ITU E.164 format limits the latter to 12 digits, but in practice not
// all countries respect that, so we relax that restriction here.
// National-only numbers are not allowed.
//
// References:
+ //
// - https://www.itu.int/rec/T-REC-E.164-201011-I
+ //
// - https://en.wikipedia.org/wiki/E.164.
+ //
// - https://en.wikipedia.org/wiki/List_of_country_calling_codes
string e164_number = 1;
// A short code.
//
// Reference(s):
- // - https://en.wikipedia.org/wiki/Short_code
+ // - https://wikipedia.org/wiki/Short_code
ShortCode short_code = 2;
}
google/type/postal_address.proto:
--- shake256:3191b0134da95315759c395e666bf891572d230fcbed1870dc0f078bba50f15ebafd6523a49e9000fa5844ad4afcbbfceafa50e58572425befdb02ce7387a144 google/type/postal_address.proto
+++ shake256:7c04d2689e3d0e5d527c2c94301d8847181e4d17c2193df82b1c083e5822be56c7686148d277f64ffac7f28311a10a516698e22dd8c1f6969c025a50981a7b72 google/type/postal_address.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -16,30 +16,29 @@
package google.type;
-option cc_enable_arenas = true;
option go_package = "google.golang.org/genproto/googleapis/type/postaladdress;postaladdress";
option java_multiple_files = true;
option java_outer_classname = "PostalAddressProto";
option java_package = "com.google.type";
option objc_class_prefix = "GTP";
-// Represents a postal address, e.g. for postal delivery or payments addresses.
-// Given a postal address, a postal service can deliver items to a premise, P.O.
-// Box or similar.
-// It is not intended to model geographical locations (roads, towns,
-// mountains).
+// Represents a postal address, such as for postal delivery or payments
+// addresses. With a postal address, a postal service can deliver items to a
+// premise, P.O. box, or similar. A postal address is not intended to model
+// geographical locations like roads, towns, or mountains.
//
-// In typical usage an address would be created via user input or from importing
+// In typical usage, an address would be created by user input or from importing
// existing data, depending on the type of process.
//
-// Advice on address input / editing:
-// - Use an i18n-ready address widget such as
-// https://github.com/google/libaddressinput)
-// - Users should not be presented with UI elements for input or editing of
-// fields outside countries where that field is used.
+// Advice on address input or editing:
//
-// For more guidance on how to use this schema, please see:
-// https://support.google.com/business/answer/6397478
+// - Use an internationalization-ready address widget such as
+// https://github.com/google/libaddressinput.
+// - Users should not be presented with UI elements for input or editing of
+// fields outside countries where that field is used.
+//
+// For more guidance on how to use this schema, see:
+// https://support.google.com/business/answer/6397478.
message PostalAddress {
// The schema revision of the `PostalAddress`. This must be set to 0, which is
// the latest revision.
@@ -49,8 +48,8 @@
// Required. CLDR region code of the country/region of the address. This
// is never inferred and it is up to the user to ensure the value is
- // correct. See http://cldr.unicode.org/ and
- // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
+ // correct. See https://cldr.unicode.org/ and
+ // https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
// for details. Example: "CH" for Switzerland.
string region_code = 2;
@@ -70,55 +69,56 @@
// Optional. Postal code of the address. Not all countries use or require
// postal codes to be present, but where they are used, they may trigger
- // additional validation with other parts of the address (e.g. state/zip
- // validation in the U.S.A.).
+ // additional validation with other parts of the address (for example,
+ // state or zip code validation in the United States).
string postal_code = 4;
// Optional. Additional, country-specific, sorting code. This is not used
// in most regions. Where it is used, the value is either a string like
- // "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
- // alone, representing the "sector code" (Jamaica), "delivery area indicator"
- // (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
+ // "CEDEX", optionally followed by a number (for example, "CEDEX 7"), or just
+ // a number alone, representing the "sector code" (Jamaica), "delivery area
+ // indicator" (Malawi) or "post office indicator" (Côte d'Ivoire).
string sorting_code = 5;
// Optional. Highest administrative subdivision which is used for postal
// addresses of a country or region.
// For example, this can be a state, a province, an oblast, or a prefecture.
- // Specifically, for Spain this is the province and not the autonomous
- // community (e.g. "Barcelona" and not "Catalonia").
- // Many countries don't use an administrative area in postal addresses. E.g.
- // in Switzerland this should be left unpopulated.
+ // For Spain, this is the province and not the autonomous
+ // community (for example, "Barcelona" and not "Catalonia").
+ // Many countries don't use an administrative area in postal addresses. For
+ // example, in Switzerland, this should be left unpopulated.
string administrative_area = 6;
- // Optional. Generally refers to the city/town portion of the address.
+ // Optional. Generally refers to the city or town portion of the address.
// Examples: US city, IT comune, UK post town.
// In regions of the world where localities are not well defined or do not fit
- // into this structure well, leave locality empty and use address_lines.
+ // into this structure well, leave `locality` empty and use `address_lines`.
string locality = 7;
// Optional. Sublocality of the address.
- // For example, this can be neighborhoods, boroughs, districts.
+ // For example, this can be a neighborhood, borough, or district.
string sublocality = 8;
// Unstructured address lines describing the lower levels of an address.
//
- // Because values in address_lines do not have type information and may
- // sometimes contain multiple values in a single field (e.g.
+ // Because values in `address_lines` do not have type information and may
+ // sometimes contain multiple values in a single field (for example,
// "Austin, TX"), it is important that the line order is clear. The order of
- // address lines should be "envelope order" for the country/region of the
- // address. In places where this can vary (e.g. Japan), address_language is
- // used to make it explicit (e.g. "ja" for large-to-small ordering and
- // "ja-Latn" or "en" for small-to-large). This way, the most specific line of
- // an address can be selected based on the language.
+ // address lines should be "envelope order" for the country or region of the
+ // address. In places where this can vary (for example, Japan),
+ // `address_language` is used to make it explicit (for example, "ja" for
+ // large-to-small ordering and "ja-Latn" or "en" for small-to-large). In this
+ // way, the most specific line of an address can be selected based on the
+ // language.
//
// The minimum permitted structural representation of an address consists
- // of a region_code with all remaining information placed in the
- // address_lines. It would be possible to format such an address very
+ // of a `region_code` with all remaining information placed in the
+ // `address_lines`. It would be possible to format such an address very
// approximately without geocoding, but no semantic reasoning could be
// made about any of the address components until it was at least
// partially resolved.
//
- // Creating an address only containing a region_code and address_lines, and
+ // Creating an address only containing a `region_code` and `address_lines` and
// then geocoding is the recommended way to handle completely unstructured
// addresses (as opposed to guessing which parts of the address should be
// localities or administrative areas).
google/type/quaternion.proto:
--- shake256:30d772d9165b775d2f3daa757ec7048f15c4ce4bd05f7938395380868b6fdb233f57ad372148eedbaa3419c7e9cb1c5f03daa3ce75b310a74b4760ee3d0b6b49 google/type/quaternion.proto
+++ shake256:31cd639b53b8b2d8b7925861ffdd0e9cc0b89b6a82f52b6e452959fd2f22f70afaebd1948e828e1eeab3cb1c4a82c6836384db0ec309138ed2e61dc625711fee google/type/quaternion.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -16,13 +16,14 @@
package google.type;
-option cc_enable_arenas = true;
option go_package = "google.golang.org/genproto/googleapis/type/quaternion;quaternion";
option java_multiple_files = true;
option java_outer_classname = "QuaternionProto";
option java_package = "com.google.type";
option objc_class_prefix = "GTP";
+// A quaternion, represented by four 64-bit floating point values.
+//
// A quaternion is defined as the quotient of two directed lines in a
// three-dimensional space or equivalently as the quotient of two Euclidean
// vectors (https://en.wikipedia.org/wiki/Quaternion).
@@ -40,7 +41,7 @@
// where x, y, z, and w are real numbers, and i, j, and k are three imaginary
// numbers.
//
-// Our naming choice `(x, y, z, w)` comes from the desire to avoid confusion for
+// The naming choice `(x, y, z, w)` comes from the desire to avoid confusion for
// those interested in the geometric properties of the quaternion in the 3D
// Cartesian space. Other texts often use alternative names or subscripts, such
// as `(a, b, c, d)`, `(1, i, j, k)`, or `(0, 1, 2, 3)`, which are perhaps
@@ -78,7 +79,6 @@
// it would produce a unique representation. It is thus recommended that `w` be
// kept positive, which can be achieved by changing all the signs when `w` is
// negative.
-//
message Quaternion {
// The x component.
double x = 1;
google/type/timeofday.proto:
--- shake256:05356f4e98446d07e8a42181c3859ed2ea6ddc2dbb8c89d1e70b8487d0279b271e5a8086bc50619634fe376b0945a2731b552d4997b2a2d80d95a2851f1df281 google/type/timeofday.proto
+++ shake256:d78652766750b4bc59893901632a663f5df452614ea1f971af75035d26ec85f07e9dda2cbb708c8fda800460bb597ed4f6f053ef479b68939aa83a309ff93719 google/type/timeofday.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@
package google.type;
-option cc_enable_arenas = true;
option go_package = "google.golang.org/genproto/googleapis/type/timeofday;timeofday";
option java_multiple_files = true;
option java_outer_classname = "TimeOfDayProto";
@@ -28,17 +27,21 @@
// types are [google.type.Date][google.type.Date] and
// `google.protobuf.Timestamp`.
message TimeOfDay {
- // Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
- // to allow the value "24:00:00" for scenarios like business closing time.
+ // Hours of a day in 24 hour format. Must be greater than or equal to 0 and
+ // typically must be less than or equal to 23. An API may choose to allow the
+ // value "24:00:00" for scenarios like business closing time.
int32 hours = 1;
- // Minutes of hour of day. Must be from 0 to 59.
+ // Minutes of an hour. Must be greater than or equal to 0 and less than or
+ // equal to 59.
int32 minutes = 2;
- // Seconds of minutes of the time. Must normally be from 0 to 59. An API may
- // allow the value 60 if it allows leap-seconds.
+ // Seconds of a minute. Must be greater than or equal to 0 and typically must
+ // be less than or equal to 59. An API may allow the value 60 if it allows
+ // leap-seconds.
int32 seconds = 3;
- // Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ // Fractions of seconds, in nanoseconds. Must be greater than or equal to 0
+ // and less than or equal to 999,999,999.
int32 nanos = 4;
}
unmultimedio
approved these changes
Mar 30, 2026
Member
unmultimedio
left a comment
unmultimedio
left a comment
There was a problem hiding this comment.
Comments and license year.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.