google-api-client 0.17.0 → 0.17.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (84) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +33 -0
  3. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  4. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +0 -8
  5. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +0 -1
  6. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +28 -184
  7. data/generated/google/apis/analyticsreporting_v4.rb +1 -1
  8. data/generated/google/apis/analyticsreporting_v4/classes.rb +56 -0
  9. data/generated/google/apis/analyticsreporting_v4/representations.rb +18 -0
  10. data/generated/google/apis/androidmanagement_v1.rb +1 -1
  11. data/generated/google/apis/bigquerydatatransfer_v1.rb +1 -1
  12. data/generated/google/apis/bigquerydatatransfer_v1/classes.rb +116 -0
  13. data/generated/google/apis/bigquerydatatransfer_v1/representations.rb +17 -0
  14. data/generated/google/apis/cloudtasks_v2beta2.rb +1 -1
  15. data/generated/google/apis/cloudtasks_v2beta2/service.rb +2 -0
  16. data/generated/google/apis/cloudtrace_v1.rb +4 -5
  17. data/generated/google/apis/cloudtrace_v1/service.rb +3 -4
  18. data/generated/google/apis/cloudtrace_v2.rb +4 -5
  19. data/generated/google/apis/cloudtrace_v2/classes.rb +18 -16
  20. data/generated/google/apis/cloudtrace_v2/service.rb +13 -16
  21. data/generated/google/apis/container_v1.rb +1 -1
  22. data/generated/google/apis/container_v1/classes.rb +1 -1
  23. data/generated/google/apis/container_v1beta1.rb +1 -1
  24. data/generated/google/apis/container_v1beta1/classes.rb +335 -1
  25. data/generated/google/apis/container_v1beta1/representations.rb +107 -0
  26. data/generated/google/apis/container_v1beta1/service.rb +482 -0
  27. data/generated/google/apis/deploymentmanager_alpha.rb +1 -1
  28. data/generated/google/apis/deploymentmanager_alpha/classes.rb +2 -1
  29. data/generated/google/apis/deploymentmanager_v2beta.rb +1 -1
  30. data/generated/google/apis/deploymentmanager_v2beta/classes.rb +2 -1
  31. data/generated/google/apis/dfareporting_v2_7.rb +1 -1
  32. data/generated/google/apis/dfareporting_v2_7/classes.rb +6 -3
  33. data/generated/google/apis/dfareporting_v2_8.rb +1 -1
  34. data/generated/google/apis/dfareporting_v2_8/classes.rb +8 -5
  35. data/generated/google/apis/dfareporting_v3_0.rb +40 -0
  36. data/generated/google/apis/dfareporting_v3_0/classes.rb +12117 -0
  37. data/generated/google/apis/dfareporting_v3_0/representations.rb +4336 -0
  38. data/generated/google/apis/dfareporting_v3_0/service.rb +9108 -0
  39. data/generated/google/apis/firebasedynamiclinks_v1.rb +1 -1
  40. data/generated/google/apis/firebasedynamiclinks_v1/classes.rb +9 -0
  41. data/generated/google/apis/firebasedynamiclinks_v1/representations.rb +1 -0
  42. data/generated/google/apis/firestore_v1beta1.rb +1 -1
  43. data/generated/google/apis/firestore_v1beta1/classes.rb +1 -0
  44. data/generated/google/apis/ml_v1.rb +1 -1
  45. data/generated/google/apis/ml_v1/classes.rb +76 -3
  46. data/generated/google/apis/ml_v1/representations.rb +7 -0
  47. data/generated/google/apis/ml_v1/service.rb +53 -0
  48. data/generated/google/apis/monitoring_v3.rb +1 -1
  49. data/generated/google/apis/monitoring_v3/service.rb +1 -5
  50. data/generated/google/apis/oslogin_v1alpha.rb +2 -2
  51. data/generated/google/apis/oslogin_v1alpha/service.rb +1 -1
  52. data/generated/google/apis/oslogin_v1beta.rb +2 -2
  53. data/generated/google/apis/oslogin_v1beta/service.rb +1 -1
  54. data/generated/google/apis/people_v1.rb +1 -1
  55. data/generated/google/apis/people_v1/classes.rb +2 -0
  56. data/generated/google/apis/people_v1/service.rb +0 -4
  57. data/generated/google/apis/script_v1.rb +1 -1
  58. data/generated/google/apis/script_v1/classes.rb +5 -6
  59. data/generated/google/apis/servicemanagement_v1.rb +1 -1
  60. data/generated/google/apis/servicemanagement_v1/classes.rb +0 -8
  61. data/generated/google/apis/servicemanagement_v1/representations.rb +0 -1
  62. data/generated/google/apis/serviceuser_v1.rb +1 -1
  63. data/generated/google/apis/serviceuser_v1/classes.rb +0 -8
  64. data/generated/google/apis/serviceuser_v1/representations.rb +0 -1
  65. data/generated/google/apis/spanner_v1.rb +1 -1
  66. data/generated/google/apis/spanner_v1/classes.rb +13 -14
  67. data/generated/google/apis/spanner_v1/service.rb +13 -13
  68. data/generated/google/apis/tagmanager_v1.rb +1 -1
  69. data/generated/google/apis/tagmanager_v1/classes.rb +70 -9
  70. data/generated/google/apis/tagmanager_v1/representations.rb +22 -3
  71. data/generated/google/apis/tagmanager_v2.rb +1 -1
  72. data/generated/google/apis/tagmanager_v2/classes.rb +7 -0
  73. data/generated/google/apis/tagmanager_v2/representations.rb +1 -0
  74. data/generated/google/apis/vision_v1.rb +1 -1
  75. data/generated/google/apis/vision_v1/classes.rb +434 -434
  76. data/generated/google/apis/vision_v1/representations.rb +178 -178
  77. data/generated/google/apis/vision_v1/service.rb +8 -8
  78. data/generated/google/apis/vision_v1p1beta1.rb +39 -0
  79. data/generated/google/apis/vision_v1p1beta1/classes.rb +1800 -0
  80. data/generated/google/apis/vision_v1p1beta1/representations.rb +728 -0
  81. data/generated/google/apis/vision_v1p1beta1/service.rb +91 -0
  82. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  83. data/lib/google/apis/version.rb +1 -1
  84. metadata +10 -2
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/analytics/devguides/reporting/core/v4/
26
26
  module AnalyticsreportingV4
27
27
  VERSION = 'V4'
28
- REVISION = '20170925'
28
+ REVISION = '20171108'
29
29
 
30
30
  # View and manage your Google Analytics data
31
31
  AUTH_ANALYTICS = 'https://www.googleapis.com/auth/analytics'
@@ -376,6 +376,21 @@ module Google
376
376
  # @return [Array<Google::Apis::AnalyticsreportingV4::ReportRequest>]
377
377
  attr_accessor :report_requests
378
378
 
379
+ # Enables
380
+ # [resource based quotas](/analytics/devguides/reporting/core/v4/limits-quotas#
381
+ # analytics_reporting_api_v4),
382
+ # (defaults to `False`). If this field is set to `True` the
383
+ # per view (profile) quotas are governed by the computational
384
+ # cost of the request. Note that using cost based quotas will
385
+ # higher enable sampling rates. (10 Million for `SMALL`,
386
+ # 100M for `LARGE`. See the
387
+ # [limits and quotas documentation](/analytics/devguides/reporting/core/v4/
388
+ # limits-quotas#analytics_reporting_api_v4) for details.
389
+ # Corresponds to the JSON property `useResourceQuotas`
390
+ # @return [Boolean]
391
+ attr_accessor :use_resource_quotas
392
+ alias_method :use_resource_quotas?, :use_resource_quotas
393
+
379
394
  def initialize(**args)
380
395
  update!(**args)
381
396
  end
@@ -383,6 +398,7 @@ module Google
383
398
  # Update properties of this object
384
399
  def update!(**args)
385
400
  @report_requests = args[:report_requests] if args.key?(:report_requests)
401
+ @use_resource_quotas = args[:use_resource_quotas] if args.key?(:use_resource_quotas)
386
402
  end
387
403
  end
388
404
 
@@ -391,18 +407,32 @@ module Google
391
407
  class GetReportsResponse
392
408
  include Google::Apis::Core::Hashable
393
409
 
410
+ # The amount of resource quota tokens deducted to execute the query. Includes
411
+ # all responses.
412
+ # Corresponds to the JSON property `queryCost`
413
+ # @return [Fixnum]
414
+ attr_accessor :query_cost
415
+
394
416
  # Responses corresponding to each of the request.
395
417
  # Corresponds to the JSON property `reports`
396
418
  # @return [Array<Google::Apis::AnalyticsreportingV4::Report>]
397
419
  attr_accessor :reports
398
420
 
421
+ # The resource quota tokens remaining for the property after the request is
422
+ # completed.
423
+ # Corresponds to the JSON property `resourceQuotasRemaining`
424
+ # @return [Google::Apis::AnalyticsreportingV4::ResourceQuotasRemaining]
425
+ attr_accessor :resource_quotas_remaining
426
+
399
427
  def initialize(**args)
400
428
  update!(**args)
401
429
  end
402
430
 
403
431
  # Update properties of this object
404
432
  def update!(**args)
433
+ @query_cost = args[:query_cost] if args.key?(:query_cost)
405
434
  @reports = args[:reports] if args.key?(:reports)
435
+ @resource_quotas_remaining = args[:resource_quotas_remaining] if args.key?(:resource_quotas_remaining)
406
436
  end
407
437
  end
408
438
 
@@ -1103,6 +1133,32 @@ module Google
1103
1133
  end
1104
1134
  end
1105
1135
 
1136
+ # The resource quota tokens remaining for the property after the request is
1137
+ # completed.
1138
+ class ResourceQuotasRemaining
1139
+ include Google::Apis::Core::Hashable
1140
+
1141
+ # Daily resource quota remaining remaining.
1142
+ # Corresponds to the JSON property `dailyQuotaTokensRemaining`
1143
+ # @return [Fixnum]
1144
+ attr_accessor :daily_quota_tokens_remaining
1145
+
1146
+ # Hourly resource quota tokens remaining.
1147
+ # Corresponds to the JSON property `hourlyQuotaTokensRemaining`
1148
+ # @return [Fixnum]
1149
+ attr_accessor :hourly_quota_tokens_remaining
1150
+
1151
+ def initialize(**args)
1152
+ update!(**args)
1153
+ end
1154
+
1155
+ # Update properties of this object
1156
+ def update!(**args)
1157
+ @daily_quota_tokens_remaining = args[:daily_quota_tokens_remaining] if args.key?(:daily_quota_tokens_remaining)
1158
+ @hourly_quota_tokens_remaining = args[:hourly_quota_tokens_remaining] if args.key?(:hourly_quota_tokens_remaining)
1159
+ end
1160
+ end
1161
+
1106
1162
  # The segment definition, if the report needs to be segmented.
1107
1163
  # A Segment is a subset of the Analytics data. For example, of the entire
1108
1164
  # set of users, one Segment might be users from a particular country or city.
@@ -178,6 +178,12 @@ module Google
178
178
  include Google::Apis::Core::JsonObjectSupport
179
179
  end
180
180
 
181
+ class ResourceQuotasRemaining
182
+ class Representation < Google::Apis::Core::JsonRepresentation; end
183
+
184
+ include Google::Apis::Core::JsonObjectSupport
185
+ end
186
+
181
187
  class Segment
182
188
  class Representation < Google::Apis::Core::JsonRepresentation; end
183
189
 
@@ -321,14 +327,18 @@ module Google
321
327
  class Representation < Google::Apis::Core::JsonRepresentation
322
328
  collection :report_requests, as: 'reportRequests', class: Google::Apis::AnalyticsreportingV4::ReportRequest, decorator: Google::Apis::AnalyticsreportingV4::ReportRequest::Representation
323
329
 
330
+ property :use_resource_quotas, as: 'useResourceQuotas'
324
331
  end
325
332
  end
326
333
 
327
334
  class GetReportsResponse
328
335
  # @private
329
336
  class Representation < Google::Apis::Core::JsonRepresentation
337
+ property :query_cost, as: 'queryCost'
330
338
  collection :reports, as: 'reports', class: Google::Apis::AnalyticsreportingV4::Report, decorator: Google::Apis::AnalyticsreportingV4::Report::Representation
331
339
 
340
+ property :resource_quotas_remaining, as: 'resourceQuotasRemaining', class: Google::Apis::AnalyticsreportingV4::ResourceQuotasRemaining, decorator: Google::Apis::AnalyticsreportingV4::ResourceQuotasRemaining::Representation
341
+
332
342
  end
333
343
  end
334
344
 
@@ -506,6 +516,14 @@ module Google
506
516
  end
507
517
  end
508
518
 
519
+ class ResourceQuotasRemaining
520
+ # @private
521
+ class Representation < Google::Apis::Core::JsonRepresentation
522
+ property :daily_quota_tokens_remaining, as: 'dailyQuotaTokensRemaining'
523
+ property :hourly_quota_tokens_remaining, as: 'hourlyQuotaTokensRemaining'
524
+ end
525
+ end
526
+
509
527
  class Segment
510
528
  # @private
511
529
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -26,7 +26,7 @@ module Google
26
26
  # @see https://developers.google.com/android/management
27
27
  module AndroidmanagementV1
28
28
  VERSION = 'V1'
29
- REVISION = '20171009'
29
+ REVISION = '20171030'
30
30
 
31
31
  # Manage Android devices and apps for your customers
32
32
  AUTH_ANDROIDMANAGEMENT = 'https://www.googleapis.com/auth/androidmanagement'
@@ -26,7 +26,7 @@ module Google
26
26
  # @see https://cloud.google.com/bigquery/
27
27
  module BigquerydatatransferV1
28
28
  VERSION = 'V1'
29
- REVISION = '20171030'
29
+ REVISION = '20171106'
30
30
 
31
31
  # View and manage your data in Google BigQuery
32
32
  AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'
@@ -560,6 +560,78 @@ module Google
560
560
  end
561
561
  end
562
562
 
563
+ # The `Status` type defines a logical error model that is suitable for different
564
+ # programming environments, including REST APIs and RPC APIs. It is used by
565
+ # [gRPC](https://github.com/grpc). The error model is designed to be:
566
+ # - Simple to use and understand for most users
567
+ # - Flexible enough to meet unexpected needs
568
+ # # Overview
569
+ # The `Status` message contains three pieces of data: error code, error message,
570
+ # and error details. The error code should be an enum value of
571
+ # google.rpc.Code, but it may accept additional error codes if needed. The
572
+ # error message should be a developer-facing English message that helps
573
+ # developers *understand* and *resolve* the error. If a localized user-facing
574
+ # error message is needed, put the localized message in the error details or
575
+ # localize it in the client. The optional error details may contain arbitrary
576
+ # information about the error. There is a predefined set of error detail types
577
+ # in the package `google.rpc` that can be used for common error conditions.
578
+ # # Language mapping
579
+ # The `Status` message is the logical representation of the error model, but it
580
+ # is not necessarily the actual wire format. When the `Status` message is
581
+ # exposed in different client libraries and different wire protocols, it can be
582
+ # mapped differently. For example, it will likely be mapped to some exceptions
583
+ # in Java, but more likely mapped to some error codes in C.
584
+ # # Other uses
585
+ # The error model and the `Status` message can be used in a variety of
586
+ # environments, either with or without APIs, to provide a
587
+ # consistent developer experience across different environments.
588
+ # Example uses of this error model include:
589
+ # - Partial errors. If a service needs to return partial errors to the client,
590
+ # it may embed the `Status` in the normal response to indicate the partial
591
+ # errors.
592
+ # - Workflow errors. A typical workflow has multiple steps. Each step may
593
+ # have a `Status` message for error reporting.
594
+ # - Batch operations. If a client uses batch request and batch response, the
595
+ # `Status` message should be used directly inside batch response, one for
596
+ # each error sub-response.
597
+ # - Asynchronous operations. If an API call embeds asynchronous operation
598
+ # results in its response, the status of those operations should be
599
+ # represented directly using the `Status` message.
600
+ # - Logging. If some API errors are stored in logs, the message `Status` could
601
+ # be used directly after any stripping needed for security/privacy reasons.
602
+ class Status
603
+ include Google::Apis::Core::Hashable
604
+
605
+ # The status code, which should be an enum value of google.rpc.Code.
606
+ # Corresponds to the JSON property `code`
607
+ # @return [Fixnum]
608
+ attr_accessor :code
609
+
610
+ # A list of messages that carry the error details. There is a common set of
611
+ # message types for APIs to use.
612
+ # Corresponds to the JSON property `details`
613
+ # @return [Array<Hash<String,Object>>]
614
+ attr_accessor :details
615
+
616
+ # A developer-facing error message, which should be in English. Any
617
+ # user-facing error message should be localized and sent in the
618
+ # google.rpc.Status.details field, or localized by the client.
619
+ # Corresponds to the JSON property `message`
620
+ # @return [String]
621
+ attr_accessor :message
622
+
623
+ def initialize(**args)
624
+ update!(**args)
625
+ end
626
+
627
+ # Update properties of this object
628
+ def update!(**args)
629
+ @code = args[:code] if args.key?(:code)
630
+ @details = args[:details] if args.key?(:details)
631
+ @message = args[:message] if args.key?(:message)
632
+ end
633
+ end
634
+
563
635
  # Represents a data transfer configuration. A transfer configuration
564
636
  # contains all metadata needed to perform a data transfer. For example,
565
637
  # `destination_dataset_id` specifies where data should be stored.
@@ -734,6 +806,49 @@ module Google
734
806
  # @return [String]
735
807
  attr_accessor :end_time
736
808
 
809
+ # The `Status` type defines a logical error model that is suitable for different
810
+ # programming environments, including REST APIs and RPC APIs. It is used by
811
+ # [gRPC](https://github.com/grpc). The error model is designed to be:
812
+ # - Simple to use and understand for most users
813
+ # - Flexible enough to meet unexpected needs
814
+ # # Overview
815
+ # The `Status` message contains three pieces of data: error code, error message,
816
+ # and error details. The error code should be an enum value of
817
+ # google.rpc.Code, but it may accept additional error codes if needed. The
818
+ # error message should be a developer-facing English message that helps
819
+ # developers *understand* and *resolve* the error. If a localized user-facing
820
+ # error message is needed, put the localized message in the error details or
821
+ # localize it in the client. The optional error details may contain arbitrary
822
+ # information about the error. There is a predefined set of error detail types
823
+ # in the package `google.rpc` that can be used for common error conditions.
824
+ # # Language mapping
825
+ # The `Status` message is the logical representation of the error model, but it
826
+ # is not necessarily the actual wire format. When the `Status` message is
827
+ # exposed in different client libraries and different wire protocols, it can be
828
+ # mapped differently. For example, it will likely be mapped to some exceptions
829
+ # in Java, but more likely mapped to some error codes in C.
830
+ # # Other uses
831
+ # The error model and the `Status` message can be used in a variety of
832
+ # environments, either with or without APIs, to provide a
833
+ # consistent developer experience across different environments.
834
+ # Example uses of this error model include:
835
+ # - Partial errors. If a service needs to return partial errors to the client,
836
+ # it may embed the `Status` in the normal response to indicate the partial
837
+ # errors.
838
+ # - Workflow errors. A typical workflow has multiple steps. Each step may
839
+ # have a `Status` message for error reporting.
840
+ # - Batch operations. If a client uses batch request and batch response, the
841
+ # `Status` message should be used directly inside batch response, one for
842
+ # each error sub-response.
843
+ # - Asynchronous operations. If an API call embeds asynchronous operation
844
+ # results in its response, the status of those operations should be
845
+ # represented directly using the `Status` message.
846
+ # - Logging. If some API errors are stored in logs, the message `Status` could
847
+ # be used directly after any stripping needed for security/privacy reasons.
848
+ # Corresponds to the JSON property `errorStatus`
849
+ # @return [Google::Apis::BigquerydatatransferV1::Status]
850
+ attr_accessor :error_status
851
+
737
852
  # The resource name of the transfer run.
738
853
  # Transfer run names have the form
739
854
  # `projects/`project_id`/locations/`location`/transferConfigs/`config_id`/runs/`
@@ -801,6 +916,7 @@ module Google
801
916
  @data_source_id = args[:data_source_id] if args.key?(:data_source_id)
802
917
  @destination_dataset_id = args[:destination_dataset_id] if args.key?(:destination_dataset_id)
803
918
  @end_time = args[:end_time] if args.key?(:end_time)
919
+ @error_status = args[:error_status] if args.key?(:error_status)
804
920
  @name = args[:name] if args.key?(:name)
805
921
  @params = args[:params] if args.key?(:params)
806
922
  @run_time = args[:run_time] if args.key?(:run_time)
@@ -100,6 +100,12 @@ module Google
100
100
  include Google::Apis::Core::JsonObjectSupport
101
101
  end
102
102
 
103
+ class Status
104
+ class Representation < Google::Apis::Core::JsonRepresentation; end
105
+
106
+ include Google::Apis::Core::JsonObjectSupport
107
+ end
108
+
103
109
  class TransferConfig
104
110
  class Representation < Google::Apis::Core::JsonRepresentation; end
105
111
 
@@ -255,6 +261,15 @@ module Google
255
261
  end
256
262
  end
257
263
 
264
+ class Status
265
+ # @private
266
+ class Representation < Google::Apis::Core::JsonRepresentation
267
+ property :code, as: 'code'
268
+ collection :details, as: 'details'
269
+ property :message, as: 'message'
270
+ end
271
+ end
272
+
258
273
  class TransferConfig
259
274
  # @private
260
275
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -289,6 +304,8 @@ module Google
289
304
  property :data_source_id, as: 'dataSourceId'
290
305
  property :destination_dataset_id, as: 'destinationDatasetId'
291
306
  property :end_time, as: 'endTime'
307
+ property :error_status, as: 'errorStatus', class: Google::Apis::BigquerydatatransferV1::Status, decorator: Google::Apis::BigquerydatatransferV1::Status::Representation
308
+
292
309
  property :name, as: 'name'
293
310
  hash :params, as: 'params'
294
311
  property :run_time, as: 'runTime'
@@ -26,7 +26,7 @@ module Google
26
26
  # @see https://cloud.google.com/cloud-tasks/
27
27
  module CloudtasksV2beta2
28
28
  VERSION = 'V2beta2'
29
- REVISION = '20171101'
29
+ REVISION = '20171106'
30
30
 
31
31
  # View and manage your data across Google Cloud Platform services
32
32
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -511,6 +511,8 @@ module Google
511
511
 
512
512
  # Sets the access control policy for a Queue. Replaces any existing
513
513
  # policy.
514
+ # Note: The Cloud Console does not check queue-level IAM permissions yet.
515
+ # Project-level permissions are required to use the Cloud Console.
514
516
  # Authorization requires the following [Google IAM](/iam) permission on the
515
517
  # specified resource parent:
516
518
  # * `cloudtasks.queues.setIamPolicy`
@@ -20,15 +20,14 @@ module Google
20
20
  module Apis
21
21
  # Stackdriver Trace API
22
22
  #
23
- # Send and retrieve trace data from Stackdriver Trace. Data is generated and
24
- # available by default for all App Engine applications. Data from other
25
- # applications can be written to Stackdriver Trace for display, reporting, and
26
- # analysis.
23
+ # Sends application trace data to Stackdriver Trace for viewing. Trace data is
24
+ # collected for all App Engine applications by default. Trace data from other
25
+ # applications can be provided using this API.
27
26
  #
28
27
  # @see https://cloud.google.com/trace
29
28
  module CloudtraceV1
30
29
  VERSION = 'V1'
31
- REVISION = '20170927'
30
+ REVISION = '20171106'
32
31
 
33
32
  # View and manage your data across Google Cloud Platform services
34
33
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -22,10 +22,9 @@ module Google
22
22
  module CloudtraceV1
23
23
  # Stackdriver Trace API
24
24
  #
25
- # Send and retrieve trace data from Stackdriver Trace. Data is generated and
26
- # available by default for all App Engine applications. Data from other
27
- # applications can be written to Stackdriver Trace for display, reporting, and
28
- # analysis.
25
+ # Sends application trace data to Stackdriver Trace for viewing. Trace data is
26
+ # collected for all App Engine applications by default. Trace data from other
27
+ # applications can be provided using this API.
29
28
  #
30
29
  # @example
31
30
  # require 'google/apis/cloudtrace_v1'
@@ -20,15 +20,14 @@ module Google
20
20
  module Apis
21
21
  # Stackdriver Trace API
22
22
  #
23
- # Send and retrieve trace data from Stackdriver Trace. Data is generated and
24
- # available by default for all App Engine applications. Data from other
25
- # applications can be written to Stackdriver Trace for display, reporting, and
26
- # analysis.
23
+ # Sends application trace data to Stackdriver Trace for viewing. Trace data is
24
+ # collected for all App Engine applications by default. Trace data from other
25
+ # applications can be provided using this API.
27
26
  #
28
27
  # @see https://cloud.google.com/trace
29
28
  module CloudtraceV2
30
29
  VERSION = 'V2'
31
- REVISION = '20171020'
30
+ REVISION = '20171106'
32
31
 
33
32
  # View and manage your data across Google Cloud Platform services
34
33
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -116,7 +116,8 @@ module Google
116
116
  class BatchWriteSpansRequest
117
117
  include Google::Apis::Core::Hashable
118
118
 
119
- # A collection of spans.
119
+ # A list of new spans. The span names must not match existing
120
+ # spans, or the results are undefined.
120
121
  # Corresponds to the JSON property `spans`
121
122
  # @return [Array<Google::Apis::CloudtraceV2::Span>]
122
123
  attr_accessor :spans
@@ -162,12 +163,12 @@ module Google
162
163
  # @return [Google::Apis::CloudtraceV2::Attributes]
163
164
  attr_accessor :attributes
164
165
 
165
- # `SPAN_ID` identifies a span within a trace.
166
+ # The [SPAN_ID] for a span within a trace.
166
167
  # Corresponds to the JSON property `spanId`
167
168
  # @return [String]
168
169
  attr_accessor :span_id
169
170
 
170
- # `TRACE_ID` identifies a trace within a project.
171
+ # The [TRACE_ID] for a trace within a project.
171
172
  # Corresponds to the JSON property `traceId`
172
173
  # @return [String]
173
174
  attr_accessor :trace_id
@@ -323,9 +324,10 @@ module Google
323
324
 
324
325
  # The resource name of the span in the following format:
325
326
  # projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/SPAN_ID is a unique
326
- # identifier for a trace within a project.
327
- # [SPAN_ID] is a unique identifier for a span within a trace,
328
- # assigned when the span is created.
327
+ # identifier for a trace within a project;
328
+ # it is a 32-character hexadecimal encoding of a 16-byte array.
329
+ # [SPAN_ID] is a unique identifier for a span within a trace; it
330
+ # is a 16-character hexadecimal encoding of an 8-byte array.
329
331
  # Corresponds to the JSON property `name`
330
332
  # @return [String]
331
333
  attr_accessor :name
@@ -336,16 +338,16 @@ module Google
336
338
  # @return [String]
337
339
  attr_accessor :parent_span_id
338
340
 
339
- # A highly recommended but not required flag that identifies when a trace
340
- # crosses a process boundary. True when the parent_span belongs to the
341
- # same process as the current span.
341
+ # (Optional) Set this parameter to indicate whether this span is in
342
+ # the same process as its parent. If you do not set this parameter,
343
+ # Stackdriver Trace is unable to take advantage of this helpful
344
+ # information.
342
345
  # Corresponds to the JSON property `sameProcessAsParentSpan`
343
346
  # @return [Boolean]
344
347
  attr_accessor :same_process_as_parent_span
345
348
  alias_method :same_process_as_parent_span?, :same_process_as_parent_span
346
349
 
347
350
  # The [SPAN_ID] portion of the span's resource name.
348
- # The ID is a 16-character hexadecimal encoding of an 8-byte array.
349
351
  # Corresponds to the JSON property `spanId`
350
352
  # @return [String]
351
353
  attr_accessor :span_id
@@ -696,12 +698,12 @@ module Google
696
698
  # @return [Fixnum]
697
699
  attr_accessor :truncated_byte_count
698
700
 
699
- # The shortened string. For example, if the original string was 500
700
- # bytes long and the limit of the string was 128 bytes, then this
701
- # value contains the first 128 bytes of the 500-byte string. Note that
702
- # truncation always happens on the character boundary, to ensure that
703
- # truncated string is still valid UTF8. In case of multi-byte characters,
704
- # size of truncated string can be less than truncation limit.
701
+ # The shortened string. For example, if the original string is 500
702
+ # bytes long and the limit of the string is 128 bytes, then
703
+ # `value` contains the first 128 bytes of the 500-byte string.
704
+ # Truncation always happens on a UTF8 character boundary. If there
705
+ # are multi-byte characters in the string, then the length of the
706
+ # shortened string might be less than the size limit.
705
707
  # Corresponds to the JSON property `value`
706
708
  # @return [String]
707
709
  attr_accessor :value