google-apis-displayvideo_v1 0.4.0 → 0.9.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -421,6 +421,69 @@ module Google
421
421
  execute_or_queue_command(command, &block)
422
422
  end
423
423
 
424
+ # Lists assigned targeting options of a campaign across targeting types.
425
+ # @param [Fixnum] advertiser_id
426
+ # Required. The ID of the advertiser the campaign belongs to.
427
+ # @param [Fixnum] campaign_id
428
+ # Required. The ID of the campaign to list assigned targeting options for.
429
+ # @param [String] filter
430
+ # Allows filtering by assigned targeting option properties. Supported syntax: *
431
+ # Filter expressions are made up of one or more restrictions. * Restrictions can
432
+ # be combined by the logical operator `OR` on the same field. * A restriction
433
+ # has the form of ``field` `operator` `value``. * The operator must be `EQUALS (=
434
+ # )`. * Supported fields: - `targetingType` - `inheritance` Examples: *
435
+ # AssignedTargetingOptions of targeting type TARGETING_TYPE_LANGUAGE or
436
+ # TARGETING_TYPE_GENDER `targetingType="TARGETING_TYPE_LANGUAGE" OR
437
+ # targetingType="TARGETING_TYPE_GENDER"` * AssignedTargetingOptions with
438
+ # inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance="
439
+ # NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"` The length of this
440
+ # field should be no more than 500 characters.
441
+ # @param [String] order_by
442
+ # Field by which to sort the list. Acceptable values are: * `targetingType` (
443
+ # default) The default sorting order is ascending. To specify descending order
444
+ # for a field, a suffix "desc" should be added to the field name. Example: `
445
+ # targetingType desc`.
446
+ # @param [Fixnum] page_size
447
+ # Requested page size. The size must be an integer between `1` and `5000`. If
448
+ # unspecified, the default is `5000`. Returns error code `INVALID_ARGUMENT` if
449
+ # an invalid value is specified.
450
+ # @param [String] page_token
451
+ # A token that lets the client fetch the next page of results. Typically, this
452
+ # is the value of next_page_token returned from the previous call to `
453
+ # BulkListCampaignAssignedTargetingOptions` method. If not specified, the first
454
+ # page of results will be returned.
455
+ # @param [String] fields
456
+ # Selector specifying which fields to include in a partial response.
457
+ # @param [String] quota_user
458
+ # Available to use for quota purposes for server-side applications. Can be any
459
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
460
+ # @param [Google::Apis::RequestOptions] options
461
+ # Request-specific options
462
+ #
463
+ # @yield [result, err] Result & error if block supplied
464
+ # @yieldparam result [Google::Apis::DisplayvideoV1::BulkListCampaignAssignedTargetingOptionsResponse] parsed result object
465
+ # @yieldparam err [StandardError] error object if request failed
466
+ #
467
+ # @return [Google::Apis::DisplayvideoV1::BulkListCampaignAssignedTargetingOptionsResponse]
468
+ #
469
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
470
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
471
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
472
+ def bulk_advertiser_campaign_list_campaign_assigned_targeting_options(advertiser_id, campaign_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
473
+ command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/campaigns/{+campaignId}:bulkListCampaignAssignedTargetingOptions', options)
474
+ command.response_representation = Google::Apis::DisplayvideoV1::BulkListCampaignAssignedTargetingOptionsResponse::Representation
475
+ command.response_class = Google::Apis::DisplayvideoV1::BulkListCampaignAssignedTargetingOptionsResponse
476
+ command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
477
+ command.params['campaignId'] = campaign_id unless campaign_id.nil?
478
+ command.query['filter'] = filter unless filter.nil?
479
+ command.query['orderBy'] = order_by unless order_by.nil?
480
+ command.query['pageSize'] = page_size unless page_size.nil?
481
+ command.query['pageToken'] = page_token unless page_token.nil?
482
+ command.query['fields'] = fields unless fields.nil?
483
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
484
+ execute_or_queue_command(command, &block)
485
+ end
486
+
424
487
  # Creates a new campaign. Returns the newly created campaign if successful.
425
488
  # @param [Fixnum] advertiser_id
426
489
  # Output only. The unique ID of the advertiser the campaign belongs to.
@@ -626,6 +689,136 @@ module Google
626
689
  execute_or_queue_command(command, &block)
627
690
  end
628
691
 
692
+ # Gets a single targeting option assigned to a campaign.
693
+ # @param [Fixnum] advertiser_id
694
+ # Required. The ID of the advertiser the campaign belongs to.
695
+ # @param [Fixnum] campaign_id
696
+ # Required. The ID of the campaign the assigned targeting option belongs to.
697
+ # @param [String] targeting_type
698
+ # Required. Identifies the type of this assigned targeting option. Supported
699
+ # targeting types: * `TARGETING_TYPE_AGE_RANGE` * `
700
+ # TARGETING_TYPE_AUTHORIZED_SELLER_STATUS` * `
701
+ # TARGETING_TYPE_CONTENT_INSTREAM_POSITION` * `
702
+ # TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION` * `
703
+ # TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION` * `TARGETING_TYPE_ENVIRONMENT`
704
+ # * `TARGETING_TYPE_EXCHANGE` * `TARGETING_TYPE_GENDER` * `
705
+ # TARGETING_TYPE_GEO_REGION` * `TARGETING_TYPE_HOUSEHOLD_INCOME` * `
706
+ # TARGETING_TYPE_INVENTORY_SOURCE` * `TARGETING_TYPE_INVENTORY_SOURCE_GROUP` * `
707
+ # TARGETING_TYPE_LANGUAGE` * `TARGETING_TYPE_ON_SCREEN_POSITION` * `
708
+ # TARGETING_TYPE_PARENTAL_STATUS` * `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION`
709
+ # * `TARGETING_TYPE_SUB_EXCHANGE` * `TARGETING_TYPE_THIRD_PARTY_VERIFIER` * `
710
+ # TARGETING_TYPE_VIEWABILITY`
711
+ # @param [String] assigned_targeting_option_id
712
+ # Required. An identifier unique to the targeting type in this campaign that
713
+ # identifies the assigned targeting option being requested.
714
+ # @param [String] fields
715
+ # Selector specifying which fields to include in a partial response.
716
+ # @param [String] quota_user
717
+ # Available to use for quota purposes for server-side applications. Can be any
718
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
719
+ # @param [Google::Apis::RequestOptions] options
720
+ # Request-specific options
721
+ #
722
+ # @yield [result, err] Result & error if block supplied
723
+ # @yieldparam result [Google::Apis::DisplayvideoV1::AssignedTargetingOption] parsed result object
724
+ # @yieldparam err [StandardError] error object if request failed
725
+ #
726
+ # @return [Google::Apis::DisplayvideoV1::AssignedTargetingOption]
727
+ #
728
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
729
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
730
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
731
+ def get_advertiser_campaign_targeting_type_assigned_targeting_option(advertiser_id, campaign_id, targeting_type, assigned_targeting_option_id, fields: nil, quota_user: nil, options: nil, &block)
732
+ command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/campaigns/{+campaignId}/targetingTypes/{+targetingType}/assignedTargetingOptions/{+assignedTargetingOptionId}', options)
733
+ command.response_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation
734
+ command.response_class = Google::Apis::DisplayvideoV1::AssignedTargetingOption
735
+ command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
736
+ command.params['campaignId'] = campaign_id unless campaign_id.nil?
737
+ command.params['targetingType'] = targeting_type unless targeting_type.nil?
738
+ command.params['assignedTargetingOptionId'] = assigned_targeting_option_id unless assigned_targeting_option_id.nil?
739
+ command.query['fields'] = fields unless fields.nil?
740
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
741
+ execute_or_queue_command(command, &block)
742
+ end
743
+
744
+ # Lists the targeting options assigned to a campaign for a specified targeting
745
+ # type.
746
+ # @param [Fixnum] advertiser_id
747
+ # Required. The ID of the advertiser the campaign belongs to.
748
+ # @param [Fixnum] campaign_id
749
+ # Required. The ID of the campaign to list assigned targeting options for.
750
+ # @param [String] targeting_type
751
+ # Required. Identifies the type of assigned targeting options to list. Supported
752
+ # targeting types: * `TARGETING_TYPE_AGE_RANGE` * `
753
+ # TARGETING_TYPE_AUTHORIZED_SELLER_STATUS` * `
754
+ # TARGETING_TYPE_CONTENT_INSTREAM_POSITION` * `
755
+ # TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION` * `
756
+ # TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION` * `TARGETING_TYPE_ENVIRONMENT`
757
+ # * `TARGETING_TYPE_EXCHANGE` * `TARGETING_TYPE_GENDER` * `
758
+ # TARGETING_TYPE_GEO_REGION` * `TARGETING_TYPE_HOUSEHOLD_INCOME` * `
759
+ # TARGETING_TYPE_INVENTORY_SOURCE` * `TARGETING_TYPE_INVENTORY_SOURCE_GROUP` * `
760
+ # TARGETING_TYPE_LANGUAGE` * `TARGETING_TYPE_ON_SCREEN_POSITION` * `
761
+ # TARGETING_TYPE_PARENTAL_STATUS` * `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION`
762
+ # * `TARGETING_TYPE_SUB_EXCHANGE` * `TARGETING_TYPE_THIRD_PARTY_VERIFIER` * `
763
+ # TARGETING_TYPE_VIEWABILITY`
764
+ # @param [String] filter
765
+ # Allows filtering by assigned targeting option properties. Supported syntax: *
766
+ # Filter expressions are made up of one or more restrictions. * Restrictions can
767
+ # be combined by the logical operator `OR`. * A restriction has the form of ``
768
+ # field` `operator` `value``. * The operator must be `EQUALS (=)`. * Supported
769
+ # fields: - `assignedTargetingOptionId` - `inheritance` Examples: *
770
+ # AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId="1" OR
771
+ # assignedTargetingOptionId="2"` * AssignedTargetingOptions with inheritance
772
+ # status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance="NOT_INHERITED"
773
+ # OR inheritance="INHERITED_FROM_PARTNER"` The length of this field should be no
774
+ # more than 500 characters.
775
+ # @param [String] order_by
776
+ # Field by which to sort the list. Acceptable values are: * `
777
+ # assignedTargetingOptionId` (default) The default sorting order is ascending.
778
+ # To specify descending order for a field, a suffix "desc" should be added to
779
+ # the field name. Example: `assignedTargetingOptionId desc`.
780
+ # @param [Fixnum] page_size
781
+ # Requested page size. Must be between `1` and `100`. If unspecified will
782
+ # default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
783
+ # specified.
784
+ # @param [String] page_token
785
+ # A token identifying a page of results the server should return. Typically,
786
+ # this is the value of next_page_token returned from the previous call to `
787
+ # ListCampaignAssignedTargetingOptions` method. If not specified, the first page
788
+ # of results will be returned.
789
+ # @param [String] fields
790
+ # Selector specifying which fields to include in a partial response.
791
+ # @param [String] quota_user
792
+ # Available to use for quota purposes for server-side applications. Can be any
793
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
794
+ # @param [Google::Apis::RequestOptions] options
795
+ # Request-specific options
796
+ #
797
+ # @yield [result, err] Result & error if block supplied
798
+ # @yieldparam result [Google::Apis::DisplayvideoV1::ListCampaignAssignedTargetingOptionsResponse] parsed result object
799
+ # @yieldparam err [StandardError] error object if request failed
800
+ #
801
+ # @return [Google::Apis::DisplayvideoV1::ListCampaignAssignedTargetingOptionsResponse]
802
+ #
803
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
804
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
805
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
806
+ def list_advertiser_campaign_targeting_type_assigned_targeting_options(advertiser_id, campaign_id, targeting_type, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
807
+ command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/campaigns/{+campaignId}/targetingTypes/{+targetingType}/assignedTargetingOptions', options)
808
+ command.response_representation = Google::Apis::DisplayvideoV1::ListCampaignAssignedTargetingOptionsResponse::Representation
809
+ command.response_class = Google::Apis::DisplayvideoV1::ListCampaignAssignedTargetingOptionsResponse
810
+ command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
811
+ command.params['campaignId'] = campaign_id unless campaign_id.nil?
812
+ command.params['targetingType'] = targeting_type unless targeting_type.nil?
813
+ command.query['filter'] = filter unless filter.nil?
814
+ command.query['orderBy'] = order_by unless order_by.nil?
815
+ command.query['pageSize'] = page_size unless page_size.nil?
816
+ command.query['pageToken'] = page_token unless page_token.nil?
817
+ command.query['fields'] = fields unless fields.nil?
818
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
819
+ execute_or_queue_command(command, &block)
820
+ end
821
+
629
822
  # Creates a new channel. Returns the newly created channel if successful.
630
823
  # @param [Fixnum] advertiser_id
631
824
  # The ID of the advertiser that owns the created channel.
@@ -931,7 +1124,7 @@ module Google
931
1124
  # for a field, a suffix " desc" should be added to the field name. Example: `
932
1125
  # urlOrAppId desc`.
933
1126
  # @param [Fixnum] page_size
934
- # Requested page size. Must be between `1` and `100`. If unspecified will
1127
+ # Requested page size. Must be between `1` and `10000`. If unspecified will
935
1128
  # default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
936
1129
  # specified.
937
1130
  # @param [String] page_token
@@ -974,6 +1167,44 @@ module Google
974
1167
  execute_or_queue_command(command, &block)
975
1168
  end
976
1169
 
1170
+ # Replaces all of the sites under a single channel. The operation will replace
1171
+ # the sites under a channel with the sites provided in ReplaceSitesRequest.
1172
+ # new_sites.
1173
+ # @param [Fixnum] advertiser_id
1174
+ # The ID of the advertiser that owns the parent channel.
1175
+ # @param [Fixnum] channel_id
1176
+ # Required. The ID of the parent channel whose sites will be replaced.
1177
+ # @param [Google::Apis::DisplayvideoV1::ReplaceSitesRequest] replace_sites_request_object
1178
+ # @param [String] fields
1179
+ # Selector specifying which fields to include in a partial response.
1180
+ # @param [String] quota_user
1181
+ # Available to use for quota purposes for server-side applications. Can be any
1182
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1183
+ # @param [Google::Apis::RequestOptions] options
1184
+ # Request-specific options
1185
+ #
1186
+ # @yield [result, err] Result & error if block supplied
1187
+ # @yieldparam result [Google::Apis::DisplayvideoV1::ReplaceSitesResponse] parsed result object
1188
+ # @yieldparam err [StandardError] error object if request failed
1189
+ #
1190
+ # @return [Google::Apis::DisplayvideoV1::ReplaceSitesResponse]
1191
+ #
1192
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1193
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1194
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1195
+ def replace_advertiser_channel_site(advertiser_id, channel_id, replace_sites_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1196
+ command = make_simple_command(:post, 'v1/advertisers/{advertiserId}/channels/{+channelId}/sites:replace', options)
1197
+ command.request_representation = Google::Apis::DisplayvideoV1::ReplaceSitesRequest::Representation
1198
+ command.request_object = replace_sites_request_object
1199
+ command.response_representation = Google::Apis::DisplayvideoV1::ReplaceSitesResponse::Representation
1200
+ command.response_class = Google::Apis::DisplayvideoV1::ReplaceSitesResponse
1201
+ command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
1202
+ command.params['channelId'] = channel_id unless channel_id.nil?
1203
+ command.query['fields'] = fields unless fields.nil?
1204
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1205
+ execute_or_queue_command(command, &block)
1206
+ end
1207
+
977
1208
  # Creates a new creative. Returns the newly created creative if successful.
978
1209
  # @param [Fixnum] advertiser_id
979
1210
  # Output only. The unique ID of the advertiser the creative belongs to.
@@ -1578,6 +1809,88 @@ module Google
1578
1809
  execute_or_queue_command(command, &block)
1579
1810
  end
1580
1811
 
1812
+ # List invoices for an advertiser.
1813
+ # @param [Fixnum] advertiser_id
1814
+ # Required. The ID of the advertiser to list invoices for.
1815
+ # @param [String] issue_month
1816
+ # Required. Month for which invoices are needed in the format YYYYMM.
1817
+ # @param [String] loi_sapin_invoice_type
1818
+ # Select type of invoice to query for Loi Sapin advertisers. Otherwise its
1819
+ # ignored.
1820
+ # @param [Fixnum] page_size
1821
+ # Requested page size. Must be between `1` and `100`. If unspecified will
1822
+ # default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
1823
+ # specified.
1824
+ # @param [String] page_token
1825
+ # A token identifying a page of results the server should return. Typically,
1826
+ # this is the value of [ListInvoicesResponse.next_page_token] returned from the
1827
+ # previous call to `ListInvoice` method. If not specified, the first page of
1828
+ # results will be returned.
1829
+ # @param [String] fields
1830
+ # Selector specifying which fields to include in a partial response.
1831
+ # @param [String] quota_user
1832
+ # Available to use for quota purposes for server-side applications. Can be any
1833
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1834
+ # @param [Google::Apis::RequestOptions] options
1835
+ # Request-specific options
1836
+ #
1837
+ # @yield [result, err] Result & error if block supplied
1838
+ # @yieldparam result [Google::Apis::DisplayvideoV1::ListInvoicesResponse] parsed result object
1839
+ # @yieldparam err [StandardError] error object if request failed
1840
+ #
1841
+ # @return [Google::Apis::DisplayvideoV1::ListInvoicesResponse]
1842
+ #
1843
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1844
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1845
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1846
+ def list_advertiser_invoices(advertiser_id, issue_month: nil, loi_sapin_invoice_type: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1847
+ command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/invoices', options)
1848
+ command.response_representation = Google::Apis::DisplayvideoV1::ListInvoicesResponse::Representation
1849
+ command.response_class = Google::Apis::DisplayvideoV1::ListInvoicesResponse
1850
+ command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
1851
+ command.query['issueMonth'] = issue_month unless issue_month.nil?
1852
+ command.query['loiSapinInvoiceType'] = loi_sapin_invoice_type unless loi_sapin_invoice_type.nil?
1853
+ command.query['pageSize'] = page_size unless page_size.nil?
1854
+ command.query['pageToken'] = page_token unless page_token.nil?
1855
+ command.query['fields'] = fields unless fields.nil?
1856
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1857
+ execute_or_queue_command(command, &block)
1858
+ end
1859
+
1860
+ # Lookup invoice currency for an advertiser.
1861
+ # @param [Fixnum] advertiser_id
1862
+ # Required. The ID of the advertiser to lookup currency for.
1863
+ # @param [String] invoice_month
1864
+ # Month for which currency is needed in the format YYYYMM. If not set Api would
1865
+ # return currency based on current settings.
1866
+ # @param [String] fields
1867
+ # Selector specifying which fields to include in a partial response.
1868
+ # @param [String] quota_user
1869
+ # Available to use for quota purposes for server-side applications. Can be any
1870
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1871
+ # @param [Google::Apis::RequestOptions] options
1872
+ # Request-specific options
1873
+ #
1874
+ # @yield [result, err] Result & error if block supplied
1875
+ # @yieldparam result [Google::Apis::DisplayvideoV1::LookupInvoiceCurrencyResponse] parsed result object
1876
+ # @yieldparam err [StandardError] error object if request failed
1877
+ #
1878
+ # @return [Google::Apis::DisplayvideoV1::LookupInvoiceCurrencyResponse]
1879
+ #
1880
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1881
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1882
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1883
+ def lookup_advertiser_invoice_invoice_currency(advertiser_id, invoice_month: nil, fields: nil, quota_user: nil, options: nil, &block)
1884
+ command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/invoices:lookupInvoiceCurrency', options)
1885
+ command.response_representation = Google::Apis::DisplayvideoV1::LookupInvoiceCurrencyResponse::Representation
1886
+ command.response_class = Google::Apis::DisplayvideoV1::LookupInvoiceCurrencyResponse
1887
+ command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
1888
+ command.query['invoiceMonth'] = invoice_month unless invoice_month.nil?
1889
+ command.query['fields'] = fields unless fields.nil?
1890
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1891
+ execute_or_queue_command(command, &block)
1892
+ end
1893
+
1581
1894
  # Bulk edits targeting options under a single line item. The operation will
1582
1895
  # delete the assigned targeting options provided in
1583
1896
  # BulkEditLineItemAssignedTargetingOptionsRequest.delete_requests and then
@@ -1750,6 +2063,43 @@ module Google
1750
2063
  execute_or_queue_command(command, &block)
1751
2064
  end
1752
2065
 
2066
+ # Creates a new line item with settings (including targeting) inherited from the
2067
+ # insertion order and an `ENTITY_STATUS_DRAFT` entity_status. Returns the newly
2068
+ # created line item if successful. There are default values based on the three
2069
+ # fields: * The insertion order's insertion_order_type * The insertion order's
2070
+ # automation_type * The given line_item_type
2071
+ # @param [Fixnum] advertiser_id
2072
+ # Required. The ID of the advertiser this line item belongs to.
2073
+ # @param [Google::Apis::DisplayvideoV1::GenerateDefaultLineItemRequest] generate_default_line_item_request_object
2074
+ # @param [String] fields
2075
+ # Selector specifying which fields to include in a partial response.
2076
+ # @param [String] quota_user
2077
+ # Available to use for quota purposes for server-side applications. Can be any
2078
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2079
+ # @param [Google::Apis::RequestOptions] options
2080
+ # Request-specific options
2081
+ #
2082
+ # @yield [result, err] Result & error if block supplied
2083
+ # @yieldparam result [Google::Apis::DisplayvideoV1::LineItem] parsed result object
2084
+ # @yieldparam err [StandardError] error object if request failed
2085
+ #
2086
+ # @return [Google::Apis::DisplayvideoV1::LineItem]
2087
+ #
2088
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2089
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2090
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2091
+ def generate_default_line_item(advertiser_id, generate_default_line_item_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2092
+ command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}/lineItems:generateDefault', options)
2093
+ command.request_representation = Google::Apis::DisplayvideoV1::GenerateDefaultLineItemRequest::Representation
2094
+ command.request_object = generate_default_line_item_request_object
2095
+ command.response_representation = Google::Apis::DisplayvideoV1::LineItem::Representation
2096
+ command.response_class = Google::Apis::DisplayvideoV1::LineItem
2097
+ command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
2098
+ command.query['fields'] = fields unless fields.nil?
2099
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2100
+ execute_or_queue_command(command, &block)
2101
+ end
2102
+
1753
2103
  # Gets a line item.
1754
2104
  # @param [Fixnum] advertiser_id
1755
2105
  # Required. The ID of the advertiser this line item belongs to.
@@ -1797,23 +2147,26 @@ module Google
1797
2147
  # ). * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (>=)`
1798
2148
  # or `LESS THAN OR EQUAL TO (<=)`. * The operator used on `warningMessages` must
1799
2149
  # be `HAS (:)`. * The operators used on all other fields must be `EQUALS (=)`. *
1800
- # Supported fields: - `campaignId` - `displayName` - `insertionOrderId` - `
2150
+ # Supported properties: - `campaignId` - `displayName` - `insertionOrderId` - `
1801
2151
  # entityStatus` - `lineItemId` - `lineItemType` - `flight.dateRange.endDate` (
1802
2152
  # input formatted as YYYY-MM-DD) - `warningMessages` - `flight.triggerId` - `
1803
- # updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) * The operator
1804
- # can be `NO LESS THAN (>=)` or `NO GREATER THAN (<=)`. - `updateTime` (format
1805
- # of ISO 8601) Examples: * All line items under an insertion order: `
1806
- # insertionOrderId="1234"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED`
1807
- # and `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: `(
1808
- # entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED")
1809
- # AND lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"` * All line items whose
1810
- # flight dates end before March 28, 2019: `flight.dateRange.endDate<"2019-03-28"`
1811
- # * All line items that have `NO_VALID_CREATIVE` in `warningMessages`: `
2153
+ # updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) - `
2154
+ # targetedChannelId` - `targetedNegativeKeywordListId` Examples: * All line
2155
+ # items under an insertion order: `insertionOrderId="1234"` * All `
2156
+ # ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and `
2157
+ # LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: `(entityStatus=
2158
+ # "ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND
2159
+ # lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"` * All line items whose flight
2160
+ # dates end before March 28, 2019: `flight.dateRange.endDate<"2019-03-28"` * All
2161
+ # line items that have `NO_VALID_CREATIVE` in `warningMessages`: `
1812
2162
  # warningMessages:"NO_VALID_CREATIVE"` * All line items with an update time less
1813
2163
  # than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime<="
1814
2164
  # 2020-11-04T18:54:47Z"` * All line items with an update time greater than or
1815
2165
  # equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime>="2020-11-
1816
- # 04T18:54:47Z"` The length of this field should be no more than 500 characters.
2166
+ # 04T18:54:47Z"` * All line items that are using both the specified channel and
2167
+ # specified negative keyword list in their targeting: `
2168
+ # targetedNegativeKeywordListId=789 AND targetedChannelId=12345` The length of
2169
+ # this field should be no more than 500 characters.
1817
2170
  # @param [String] order_by
1818
2171
  # Field by which to sort the list. Acceptable values are: * "displayName" (
1819
2172
  # default) * "entityStatus" * “flight.dateRange.endDate” * "updateTime" The
@@ -2982,7 +3335,7 @@ module Google
2982
3335
  # for a field, a suffix " desc" should be added to the field name. Example: `
2983
3336
  # keywordValue desc`.
2984
3337
  # @param [Fixnum] page_size
2985
- # Requested page size. Must be between `1` and `100`. If unspecified will
3338
+ # Requested page size. Must be between `1` and `1000`. If unspecified will
2986
3339
  # default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
2987
3340
  # specified.
2988
3341
  # @param [String] page_token
@@ -3022,6 +3375,46 @@ module Google
3022
3375
  execute_or_queue_command(command, &block)
3023
3376
  end
3024
3377
 
3378
+ # Replaces all negative keywords in a single negative keyword list. The
3379
+ # operation will replace the keywords in a negative keyword list with keywords
3380
+ # provided in ReplaceNegativeKeywordsRequest.new_negative_keywords.
3381
+ # @param [Fixnum] advertiser_id
3382
+ # Required. The ID of the DV360 advertiser to which the parent negative keyword
3383
+ # list belongs.
3384
+ # @param [Fixnum] negative_keyword_list_id
3385
+ # Required. The ID of the parent negative keyword list to which the negative
3386
+ # keywords belong.
3387
+ # @param [Google::Apis::DisplayvideoV1::ReplaceNegativeKeywordsRequest] replace_negative_keywords_request_object
3388
+ # @param [String] fields
3389
+ # Selector specifying which fields to include in a partial response.
3390
+ # @param [String] quota_user
3391
+ # Available to use for quota purposes for server-side applications. Can be any
3392
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3393
+ # @param [Google::Apis::RequestOptions] options
3394
+ # Request-specific options
3395
+ #
3396
+ # @yield [result, err] Result & error if block supplied
3397
+ # @yieldparam result [Google::Apis::DisplayvideoV1::ReplaceNegativeKeywordsResponse] parsed result object
3398
+ # @yieldparam err [StandardError] error object if request failed
3399
+ #
3400
+ # @return [Google::Apis::DisplayvideoV1::ReplaceNegativeKeywordsResponse]
3401
+ #
3402
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3403
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3404
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3405
+ def replace_negative_keywords(advertiser_id, negative_keyword_list_id, replace_negative_keywords_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3406
+ command = make_simple_command(:post, 'v1/advertisers/{advertiserId}/negativeKeywordLists/{+negativeKeywordListId}/negativeKeywords:replace', options)
3407
+ command.request_representation = Google::Apis::DisplayvideoV1::ReplaceNegativeKeywordsRequest::Representation
3408
+ command.request_object = replace_negative_keywords_request_object
3409
+ command.response_representation = Google::Apis::DisplayvideoV1::ReplaceNegativeKeywordsResponse::Representation
3410
+ command.response_class = Google::Apis::DisplayvideoV1::ReplaceNegativeKeywordsResponse
3411
+ command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
3412
+ command.params['negativeKeywordListId'] = negative_keyword_list_id unless negative_keyword_list_id.nil?
3413
+ command.query['fields'] = fields unless fields.nil?
3414
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3415
+ execute_or_queue_command(command, &block)
3416
+ end
3417
+
3025
3418
  # Assigns a targeting option to an advertiser. Returns the assigned targeting
3026
3419
  # option if successful.
3027
3420
  # @param [Fixnum] advertiser_id
@@ -4738,7 +5131,7 @@ module Google
4738
5131
  # for a field, a suffix " desc" should be added to the field name. Example: `
4739
5132
  # urlOrAppId desc`.
4740
5133
  # @param [Fixnum] page_size
4741
- # Requested page size. Must be between `1` and `100`. If unspecified will
5134
+ # Requested page size. Must be between `1` and `10000`. If unspecified will
4742
5135
  # default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
4743
5136
  # specified.
4744
5137
  # @param [String] page_token
@@ -4779,6 +5172,44 @@ module Google
4779
5172
  execute_or_queue_command(command, &block)
4780
5173
  end
4781
5174
 
5175
+ # Replaces all of the sites under a single channel. The operation will replace
5176
+ # the sites under a channel with the sites provided in ReplaceSitesRequest.
5177
+ # new_sites.
5178
+ # @param [Fixnum] partner_id
5179
+ # The ID of the partner that owns the parent channel.
5180
+ # @param [Fixnum] channel_id
5181
+ # Required. The ID of the parent channel whose sites will be replaced.
5182
+ # @param [Google::Apis::DisplayvideoV1::ReplaceSitesRequest] replace_sites_request_object
5183
+ # @param [String] fields
5184
+ # Selector specifying which fields to include in a partial response.
5185
+ # @param [String] quota_user
5186
+ # Available to use for quota purposes for server-side applications. Can be any
5187
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5188
+ # @param [Google::Apis::RequestOptions] options
5189
+ # Request-specific options
5190
+ #
5191
+ # @yield [result, err] Result & error if block supplied
5192
+ # @yieldparam result [Google::Apis::DisplayvideoV1::ReplaceSitesResponse] parsed result object
5193
+ # @yieldparam err [StandardError] error object if request failed
5194
+ #
5195
+ # @return [Google::Apis::DisplayvideoV1::ReplaceSitesResponse]
5196
+ #
5197
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5198
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5199
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5200
+ def replace_partner_channel_site(partner_id, channel_id, replace_sites_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5201
+ command = make_simple_command(:post, 'v1/partners/{partnerId}/channels/{+channelId}/sites:replace', options)
5202
+ command.request_representation = Google::Apis::DisplayvideoV1::ReplaceSitesRequest::Representation
5203
+ command.request_object = replace_sites_request_object
5204
+ command.response_representation = Google::Apis::DisplayvideoV1::ReplaceSitesResponse::Representation
5205
+ command.response_class = Google::Apis::DisplayvideoV1::ReplaceSitesResponse
5206
+ command.params['partnerId'] = partner_id unless partner_id.nil?
5207
+ command.params['channelId'] = channel_id unless channel_id.nil?
5208
+ command.query['fields'] = fields unless fields.nil?
5209
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5210
+ execute_or_queue_command(command, &block)
5211
+ end
5212
+
4782
5213
  # Assigns a targeting option to a partner. Returns the assigned targeting option
4783
5214
  # if successful.
4784
5215
  # @param [Fixnum] partner_id