Release 49.0.0.

googleads · Sep 28, 2020 · 94160b7 · 94160b7
1 parent 61feeae
commit 94160b7
Show file tree

Hide file tree

Showing 35 changed files with 1,541 additions and 528 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,20 @@
+### 49.0.0
+
+##### AdWords
+
+*   No changes.
+
+##### Ad Manager
+
+*   Fixed [issue #675](https://github.com/googleads/googleads-php-lib/issues/675)
+by replacing an exception with a warning when network code is missing from the
+adsapi_php.ini file.
+
+##### Common
+
+*   Fixed [issue #679](https://github.com/googleads/googleads-php-lib/issues/679)
+by updating `guzzlehttp/guzzle` to version 7.
+
 ### 48.0.0
 
 ##### AdWords

diff --git a/examples/AdWords/LaravelSampleApp/composer.lock b/examples/AdWords/LaravelSampleApp/composer.lock
diff --git a/resources/wsdls/api/adwords/cm/v201809/AdGroupAdService.wsdl b/resources/wsdls/api/adwords/cm/v201809/AdGroupAdService.wsdl
@@ -3996,7 +3996,7 @@
                     Image displayed in the expanded view of the Showcase shopping ad.
                     &lt;p&gt;The format of the image must be either JPEG or PNG and the size of the image must be
                     1080x566 px.
-                    &lt;span class="constraint Required"&gt;This field is required and should not be {@code null} when it is contained within {@link Operator}s : ADD.&lt;/span&gt;
+                    &lt;p&gt;Expanded image is deprecated and will be ignored if set.
                   </documentation>
                 </annotation>
               </element>

diff --git a/resources/wsdls/api/adwords/cm/v201809/AdGroupCriterionService.wsdl b/resources/wsdls/api/adwords/cm/v201809/AdGroupCriterionService.wsdl
@@ -836,7 +836,6 @@
                 &lt;p&gt;Starting with v201705, this field cannot be set at the ad group or ad group criterion level.
                 &lt;span class="constraint Selectable"&gt;This field can be selected using the value "BiddingStrategyId".&lt;/span&gt;&lt;span class="constraint Filterable"&gt;This field can be filtered on.&lt;/span&gt;
                 &lt;span class="constraint AdxEnabled"&gt;This is disabled for AdX.&lt;/span&gt;
-                &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
               </documentation>
             </annotation>
           </element>
@@ -887,7 +886,6 @@
                 href="https://developers.google.com/adwords/api/docs/guides/bidding"&gt;bidding guide&lt;/a&gt;.
 
                 &lt;p&gt;Starting with v201705, this field cannot be set at the ad group or ad group criterion level.
-                &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
               </documentation>
             </annotation>
           </element>
@@ -910,7 +908,6 @@
                 ad group's effective bidding strategy is a standard {@code TARGET_ROAS} strategy attached to
                 the campaign, then the target overrides the target roas specified in the campaign's bidding
                 strategy. Otherwise, this value is ignored.
-                &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
                 &lt;span class="constraint InRange"&gt;This field must be between 0.01 and 1000.0, inclusive.&lt;/span&gt;
               </documentation>
             </annotation>
@@ -1863,7 +1860,6 @@
                     the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the
                     bid strategy will aim to achieve the highest possible ROAS for the budget. Use {@code 0.0} to
                     clear an existing value.
-                    &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
                     &lt;span class="constraint InRange"&gt;This field must be between 0.01 and 1000.0, inclusive.&lt;/span&gt;
                   </documentation>
                 </annotation>

diff --git a/resources/wsdls/api/adwords/cm/v201809/AdGroupService.wsdl b/resources/wsdls/api/adwords/cm/v201809/AdGroupService.wsdl
@@ -629,7 +629,6 @@
                 &lt;p&gt;Starting with v201705, this field cannot be set at the ad group or ad group criterion level.
                 &lt;span class="constraint Selectable"&gt;This field can be selected using the value "BiddingStrategyId".&lt;/span&gt;&lt;span class="constraint Filterable"&gt;This field can be filtered on.&lt;/span&gt;
                 &lt;span class="constraint AdxEnabled"&gt;This is disabled for AdX.&lt;/span&gt;
-                &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
               </documentation>
             </annotation>
           </element>
@@ -680,7 +679,6 @@
                 href="https://developers.google.com/adwords/api/docs/guides/bidding"&gt;bidding guide&lt;/a&gt;.
 
                 &lt;p&gt;Starting with v201705, this field cannot be set at the ad group or ad group criterion level.
-                &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
               </documentation>
             </annotation>
           </element>
@@ -1431,7 +1429,6 @@
                     the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the
                     bid strategy will aim to achieve the highest possible ROAS for the budget. Use {@code 0.0} to
                     clear an existing value.
-                    &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
                     &lt;span class="constraint InRange"&gt;This field must be between 0.01 and 1000.0, inclusive.&lt;/span&gt;
                   </documentation>
                 </annotation>

diff --git a/resources/wsdls/api/adwords/cm/v201809/AdService.wsdl b/resources/wsdls/api/adwords/cm/v201809/AdService.wsdl
@@ -3644,7 +3644,7 @@
                     Image displayed in the expanded view of the Showcase shopping ad.
                     &lt;p&gt;The format of the image must be either JPEG or PNG and the size of the image must be
                     1080x566 px.
-                    &lt;span class="constraint Required"&gt;This field is required and should not be {@code null} when it is contained within {@link Operator}s : SET.&lt;/span&gt;
+                    &lt;p&gt;Expanded image is deprecated and will be ignored if set.
                   </documentation>
                 </annotation>
               </element>

diff --git a/resources/wsdls/api/adwords/cm/v201809/BatchJobOpsService.wsdl b/resources/wsdls/api/adwords/cm/v201809/BatchJobOpsService.wsdl
@@ -2771,7 +2771,6 @@
               <documentation>
                 Stores information specific to Universal App Campaigns.
                 &lt;span class="constraint CampaignType"&gt;This field may only be set for campaign channel type MULTI_CHANNEL.&lt;/span&gt;
-&lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
               </documentation>
             </annotation>
           </element>
@@ -6323,7 +6322,6 @@
                     the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the
                     bid strategy will aim to achieve the highest possible ROAS for the budget. Use {@code 0.0} to
                     clear an existing value.
-                    &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
                     &lt;span class="constraint InRange"&gt;This field must be between 0.01 and 1000.0, inclusive.&lt;/span&gt;
                   </documentation>
                 </annotation>
@@ -9716,7 +9714,7 @@
                     Image displayed in the expanded view of the Showcase shopping ad.
                     &lt;p&gt;The format of the image must be either JPEG or PNG and the size of the image must be
                     1080x566 px.
-                    &lt;span class="constraint Required"&gt;This field is required and should not be {@code null} when it is contained within {@link Operator}s : ADD.&lt;/span&gt;
+                    &lt;p&gt;Expanded image is deprecated and will be ignored if set.
                   </documentation>
                 </annotation>
               </element>
@@ -15044,7 +15042,6 @@
             <annotation>
               <documentation>
                 Games
-                &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
               </documentation>
             </annotation>
           </enumeration>

diff --git a/resources/wsdls/api/adwords/cm/v201809/BiddingStrategyService.wsdl b/resources/wsdls/api/adwords/cm/v201809/BiddingStrategyService.wsdl
@@ -720,7 +720,6 @@
                     bid strategy will aim to achieve the highest possible ROAS for the budget. Use {@code 0.0} to
                     clear an existing value.
                     &lt;span class="constraint Selectable"&gt;This field can be selected using the value "MaximizeConversionValueTargetRoas".&lt;/span&gt;&lt;span class="constraint Filterable"&gt;This field can be filtered on.&lt;/span&gt;
-                    &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
                     &lt;span class="constraint InRange"&gt;This field must be between 0.01 and 1000.0, inclusive.&lt;/span&gt;
                   </documentation>
                 </annotation>

diff --git a/resources/wsdls/api/adwords/cm/v201809/CampaignCriterionService.wsdl b/resources/wsdls/api/adwords/cm/v201809/CampaignCriterionService.wsdl
@@ -3592,7 +3592,6 @@
             <annotation>
               <documentation>
                 Games
-                &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
               </documentation>
             </annotation>
           </enumeration>

diff --git a/resources/wsdls/api/adwords/cm/v201809/CampaignService.wsdl b/resources/wsdls/api/adwords/cm/v201809/CampaignService.wsdl
@@ -299,6 +299,7 @@
                 to any value other than {@code BiddingStrategyType.NONE}.
                 &lt;span class="constraint Selectable"&gt;This field can be selected using the value "BiddingStrategyType".&lt;/span&gt;&lt;span class="constraint Filterable"&gt;This field can be filtered on.&lt;/span&gt;
                 &lt;span class="constraint CampaignType"&gt;This field may only be set to the values: MANUAL_CPC, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSION_VALUE, MAXIMIZE_CONVERSIONS, TARGET_OUTRANK_SHARE for campaign channel type SEARCH.&lt;/span&gt;
+&lt;span class="constraint CampaignType"&gt;This field may only be set to the values: MANUAL_CPC, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSION_VALUE, MAXIMIZE_CONVERSIONS, TARGET_OUTRANK_SHARE for campaign channel type SEARCH with campaign channel subtype SEARCH_EXPRESS.&lt;/span&gt;
 &lt;span class="constraint CampaignType"&gt;This field may only be set to the values: MANUAL_CPC, TARGET_ROAS, TARGET_SPEND for campaign channel type SHOPPING.&lt;/span&gt;
 &lt;span class="constraint CampaignType"&gt;This field may only be set to MAXIMIZE_CONVERSION_VALUE for campaign channel type SHOPPING with campaign channel subtype SHOPPING_GOAL_OPTIMIZED_ADS.&lt;/span&gt;
 &lt;span class="constraint CampaignType"&gt;This field may only be set to the values: MANUAL_CPC, MANUAL_CPM, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS for campaign channel type DISPLAY.&lt;/span&gt;
@@ -342,7 +343,6 @@
                 Default CPC and CPM bid values will be set if they are not provided during {@linkplain AdGroup}
                 creation. Default CPC and CPM values are minimal billable amounts in local currencies.
                 For example, for US Dollars CPC and CPM default values are $0.01 and $0.01, respectively.
-                &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
               </documentation>
             </annotation>
           </element>
@@ -353,7 +353,6 @@
                 ad group's effective bidding strategy is a standard {@code TARGET_ROAS} strategy attached to
                 the campaign, then the target overrides the target roas specified in the campaign's bidding
                 strategy. Otherwise, this value is ignored.
-                &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
                 &lt;span class="constraint InRange"&gt;This field must be between 0.01 and 1000.0, inclusive.&lt;/span&gt;
               </documentation>
             </annotation>
@@ -747,7 +746,6 @@
               <documentation>
                 Stores information specific to Universal App Campaigns.
                 &lt;span class="constraint CampaignType"&gt;This field may only be set for campaign channel type MULTI_CHANNEL.&lt;/span&gt;
-&lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
               </documentation>
             </annotation>
           </element>
@@ -1918,7 +1916,6 @@
                     clear an existing value.
                     &lt;span class="constraint Selectable"&gt;This field can be selected using the value "MaximizeConversionValueTargetRoas".&lt;/span&gt;&lt;span class="constraint Filterable"&gt;This field can be filtered on.&lt;/span&gt;
                     &lt;span class="constraint CampaignType"&gt;This field may only be set for campaign channel subtype SHOPPING_GOAL_OPTIMIZED_ADS.&lt;/span&gt;
-&lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
                     &lt;span class="constraint InRange"&gt;This field must be between 0.01 and 1000.0, inclusive.&lt;/span&gt;
                   </documentation>
                 </annotation>

diff --git a/resources/wsdls/api/adwords/cm/v201809/CustomerNegativeCriterionService.wsdl b/resources/wsdls/api/adwords/cm/v201809/CustomerNegativeCriterionService.wsdl
@@ -1634,7 +1634,6 @@
             <annotation>
               <documentation>
                 Games
-                &lt;span class="constraint CampaignType"&gt;This field may not be set.&lt;/span&gt;
               </documentation>
             </annotation>
           </enumeration>

diff --git a/resources/wsdls/apis/ads/publisher/v201911/LiveStreamEventService.wsdl b/resources/wsdls/apis/ads/publisher/v201911/LiveStreamEventService.wsdl
@@ -2482,6 +2482,38 @@
             &lt;td&gt;{@code id}&lt;/td&gt;
             &lt;td&gt;{@link LiveStreamEvent#id}&lt;/td&gt;
             &lt;/tr&gt;
+            &lt;tr&gt;
+            &lt;td&gt;{@code slateCreativeId}&lt;/td&gt;
+            &lt;td&gt;{@link LiveStreamEvent#slateCreativeId}&lt;/td&gt;
+            &lt;/tr&gt;
+            &lt;tr&gt;
+            &lt;td&gt;{@code assetKey}&lt;/td&gt;
+            &lt;td&gt;{@link LiveStreamEvent#assetKey}&lt;/td&gt;
+            &lt;/tr&gt;
+            &lt;tr&gt;
+            &lt;td&gt;{@code streamCreateDaiAuthenticationKeyIds}&lt;/td&gt;
+            &lt;td&gt;{@link LiveStreamEvent#streamCreateDaiAuthenticationKeyIds}&lt;/td&gt;
+            &lt;/tr&gt;
+            &lt;tr&gt;
+            &lt;td&gt;{@code dynamicAdInsertionType}&lt;/td&gt;
+            &lt;td&gt;{@link LiveStreamEvent#dynamicAdInsertionType}&lt;/td&gt;
+            &lt;/tr&gt;
+            &lt;tr&gt;
+            &lt;td&gt;{@code streamingFormat}&lt;/td&gt;
+            &lt;td&gt;{@link LiveStreamEvent#streamingFormat}&lt;/td&gt;
+            &lt;/tr&gt;
+            &lt;tr&gt;
+            &lt;td&gt;{@code customAssetKey}&lt;/td&gt;
+            &lt;td&gt;{@link LiveStreamEvent#customAssetKey}&lt;/td&gt;
+            &lt;/tr&gt;
+            &lt;tr&gt;
+            &lt;td&gt;{@code daiEncodingProfileIds}&lt;/td&gt;
+            &lt;td&gt;{@link LiveStreamEvent#daiEncodingProfileIds}&lt;/td&gt;
+            &lt;/tr&gt;
+            &lt;tr&gt;
+            &lt;td&gt;{@code segmentUrlAuthenticationKeyIds}&lt;/td&gt;
+            &lt;td&gt;{@link LiveStreamEvent#segmentUrlAuthenticationKeyIds}&lt;/td&gt;
+            &lt;/tr&gt;
             &lt;/table&gt;
 
             @param filterStatement a Publisher Query Language statement to filter a
@@ -2628,8 +2660,9 @@
     <wsdl:documentation>
       Provides methods for creating, updating and retrieving {@link LiveStreamEvent} objects.
 
-      &lt;p&gt;This feature is not yet openly available for DFP Video publishers. Publishers will need to
-      apply for access for this feature through their account managers.
+      &lt;p&gt;This feature is only available for Ad Manager 360 networks.
+      Publishers will need to be activated through the &lt;b&gt;Video &gt; Live streams&lt;/b&gt;
+      tab in the Ad Manager UI. For access, apply through your account manager.
     </wsdl:documentation>
     <wsdl:operation name="createLiveStreamEvents">
       <wsdl:documentation>
@@ -2665,6 +2698,38 @@
         &lt;td&gt;{@code id}&lt;/td&gt;
         &lt;td&gt;{@link LiveStreamEvent#id}&lt;/td&gt;
         &lt;/tr&gt;
+        &lt;tr&gt;
+        &lt;td&gt;{@code slateCreativeId}&lt;/td&gt;
+        &lt;td&gt;{@link LiveStreamEvent#slateCreativeId}&lt;/td&gt;
+        &lt;/tr&gt;
+        &lt;tr&gt;
+        &lt;td&gt;{@code assetKey}&lt;/td&gt;
+        &lt;td&gt;{@link LiveStreamEvent#assetKey}&lt;/td&gt;
+        &lt;/tr&gt;
+        &lt;tr&gt;
+        &lt;td&gt;{@code streamCreateDaiAuthenticationKeyIds}&lt;/td&gt;
+        &lt;td&gt;{@link LiveStreamEvent#streamCreateDaiAuthenticationKeyIds}&lt;/td&gt;
+        &lt;/tr&gt;
+        &lt;tr&gt;
+        &lt;td&gt;{@code dynamicAdInsertionType}&lt;/td&gt;
+        &lt;td&gt;{@link LiveStreamEvent#dynamicAdInsertionType}&lt;/td&gt;
+        &lt;/tr&gt;
+        &lt;tr&gt;
+        &lt;td&gt;{@code streamingFormat}&lt;/td&gt;
+        &lt;td&gt;{@link LiveStreamEvent#streamingFormat}&lt;/td&gt;
+        &lt;/tr&gt;
+        &lt;tr&gt;
+        &lt;td&gt;{@code customAssetKey}&lt;/td&gt;
+        &lt;td&gt;{@link LiveStreamEvent#customAssetKey}&lt;/td&gt;
+        &lt;/tr&gt;
+        &lt;tr&gt;
+        &lt;td&gt;{@code daiEncodingProfileIds}&lt;/td&gt;
+        &lt;td&gt;{@link LiveStreamEvent#daiEncodingProfileIds}&lt;/td&gt;
+        &lt;/tr&gt;
+        &lt;tr&gt;
+        &lt;td&gt;{@code segmentUrlAuthenticationKeyIds}&lt;/td&gt;
+        &lt;td&gt;{@link LiveStreamEvent#segmentUrlAuthenticationKeyIds}&lt;/td&gt;
+        &lt;/tr&gt;
         &lt;/table&gt;
 
         @param filterStatement a Publisher Query Language statement to filter a