Skip to content

Commit 6dc0d7a

Browse files
committed
Release 25.1.0.
1 parent b7407dd commit 6dc0d7a

23 files changed

+1559
-30
lines changed

CHANGELOG.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,28 @@
1+
### 25.1.0
2+
3+
##### AdWords
4+
5+
* Fixed
6+
[issue #197](https://github.com/googleads/googleads-php-lib/issues/197).
7+
* Accepted [PR #203](https://github.com/googleads/googleads-php-lib/pull/203).
8+
* Fixed
9+
[issue #206](https://github.com/googleads/googleads-php-lib/issues/206).
10+
* Fixed some examples that had issues with printing results.
11+
12+
##### DFP
13+
14+
* Accepted [PR #195](https://github.com/googleads/googleads-php-lib/pull/195).
15+
* Added RunSavedQuery.php reporting example.
16+
* Added RunDeliveryReportForOrder.php reporting example.
17+
* Added forecast service examples.
18+
19+
##### Common
20+
21+
* Fixed
22+
[issue #200](https://github.com/googleads/googleads-php-lib/issues/200).
23+
* Fixed
24+
[issue #210](https://github.com/googleads/googleads-php-lib/issues/210).
25+
126
### 25.0.0
227

328
##### AdWords
@@ -21,8 +46,8 @@
2146

2247
##### Common
2348

24-
* Library is now stable and no longer in beta. See the
25-
[Upgrading guide](https://github.com/googleads/googleads-php-lib/blob/master/UPGRADING.md)
49+
* Library is now stable and no longer in beta. See the [Upgrading
50+
guide](https://github.com/googleads/googleads-php-lib/blob/master/UPGRADING.md)
2651
for details on how to upgrade.
2752
* Fixed the issue that some enum values whose names conflict with PHP reserved
2853
keywords were generated by prepending "a", e.g., "aDEFAULT". They are now

UPGRADING.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ SSL settings | `sett
8484
AdWords settings (e.g., client customer ID, dev token) | `auth.ini` or [AdWordsUser](https://github.com/googleads/googleads-php-lib/blob/deprecated/src/Google/Api/Ads/AdWords/Lib/AdWordsUser.php) | `adsapi_php.ini` or `AdsSession` using [AdWordsSessionBuilder.php](https://github.com/googleads/googleads-php-lib/blob/master/src/Google/AdsApi/AdWords/AdWordsSessionBuilder.php)
8585
AdWords reporting settings | `ReportUtils` | `adsapi_php.ini` or `AdsSession` using [ReportSettingsBuilder.php](https://github.com/googleads/googleads-php-lib/blob/master/src/Google/AdsApi/AdWords/ReportSettingsBuilder.php)
8686
**DFP** | |
87-
DFP settings (e.g., network code) | auth.ini or [DfpUser](https://github.com/googleads/googleads-php-lib/blob/deprecated/src/Google/Api/Ads/Dfp/Lib/DfpUser.php) | `adsapi_php.ini` or `AdsSession` using [DfpSessionBuilder.php](https://github.com/googleads/googleads-php-lib/blob/master/src/Google/AdsApi/Dfp/DfpSessionBuilder.php)
87+
DFP settings (e.g., network code) | `auth.ini` or [DfpUser](https://github.com/googleads/googleads-php-lib/blob/deprecated/src/Google/Api/Ads/Dfp/Lib/DfpUser.php) | `adsapi_php.ini` or `AdsSession` using [DfpSessionBuilder.php](https://github.com/googleads/googleads-php-lib/blob/master/src/Google/AdsApi/Dfp/DfpSessionBuilder.php)
8888

8989
For a more detailed example of how you can configure settings in the new
9090
library, see the [Basic
@@ -100,7 +100,7 @@ the new library to support features such as OAuth2 service accounts and more.
100100
------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -----------
101101
OAuth2 library | [OAuth2Handler.php](https://github.com/googleads/googleads-php-lib/blob/deprecated/src/Google/Api/Ads/Common/Util/OAuth2Handler.php) | PHP Google Auth Library
102102
Supported OAuth2 flows | [Installed application flow](https://github.com/googleads/googleads-php-lib/wiki/%5BDeprecated,-old-library%5D-API-access-using-own-credentials-\(installed-application-flow\)). | [Installed application flow](https://github.com/googleads/googleads-php-lib/wiki/API-access-using-own-credentials-\(installed-application-flow\)), [web flow](https://github.com/googleads/googleads-php-lib/wiki/API-access-on-behalf-of-your-clients-\(web-flow\)), [service account flow](https://github.com/googleads/googleads-php-lib/wiki/API-access-using-own-credentials-\(server-to-server-flow\)).
103-
Installed application flow refresh token utility | In examples `Auth` folder under [AdWords](https://github.com/googleads/googleads-php-lib/tree/deprecated/examples/AdWords/Auth) or [DFP](https://github.com/googleads/googleads-php-lib/tree/deprecated/examples/AdWords/Auth). | Consolidated into one [auth example](https://github.com/googleads/googleads-php-lib/blob/master/examples/Auth/GetRefreshToken.php).
103+
Installed application flow refresh token utility | In examples `Auth` folder under [AdWords](https://github.com/googleads/googleads-php-lib/tree/deprecated/examples/AdWords/Auth) or [DFP](https://github.com/googleads/googleads-php-lib/tree/deprecated/examples/Dfp/Auth). | Consolidated into one [auth example](https://github.com/googleads/googleads-php-lib/blob/master/examples/Auth/GetRefreshToken.php).
104104

105105
## Logging
106106

composer.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
"php": ">=5.5.9",
66
"ext-openssl": "*",
77
"ext-soap": "*",
8-
"google/auth": "^0.7",
8+
"google/auth": "^0.11.0",
99
"guzzlehttp/guzzle": "^6.0",
1010
"guzzlehttp/psr7": "^1.2",
1111
"monolog/monolog": "^1.17.1",

examples/AdWords/v201609/AccountManagement/CreateAccount.php

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -68,10 +68,11 @@ public static function main() {
6868

6969
// Construct an API session configured from a properties file and the OAuth2
7070
// credentials above.
71+
// You can use withClientCustomerId() of AdWordsSessionBuilder to specify
72+
// your manager account ID under which you want to create an account.
7173
$session = (new AdWordsSessionBuilder())
7274
->fromFile()
7375
->withOAuth2Credential($oAuth2Credential)
74-
->withClientCustomerId('176-504-4936')
7576
->build();
7677
self::runExample(new AdWordsServices(), $session);
7778
}

examples/AdWords/v201609/AdvancedOperations/AddUniversalAppCampaign.php

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -101,11 +101,11 @@ public static function runExample(AdWordsServices $adWordsServices,
101101
// Set the campaign's assets and ad text ideas. These values will be used to
102102
// generate ads.
103103
$universalAppSetting = new UniversalAppCampaignSetting();
104-
$universalAppSetting->setAppId('com.interplanetarycruise.booking');
105-
$universalAppSetting->setDescription1('Best Space Cruise Line');
106-
$universalAppSetting->setDescription2('Visit all the planets');
107-
$universalAppSetting->setDescription3('Trips 7 days a week');
108-
$universalAppSetting->setDescription4('Buy your tickets now!');
104+
$universalAppSetting->setAppId('com.labpixies.colordrips');
105+
$universalAppSetting->setDescription1('A cool puzzle game');
106+
$universalAppSetting->setDescription2('Remove connected blocks');
107+
$universalAppSetting->setDescription3('3 difficulty levels');
108+
$universalAppSetting->setDescription4('4 colorful fun skins');
109109

110110
// Optional: You can set up to 10 image assets for your campaign.
111111
// See UploadImage.php for an example on how to upload images.

examples/AdWords/v201609/BasicOperations/PauseAd.php

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,10 +65,10 @@ public static function runExample(AdWordsServices $adWordsServices,
6565
$operations[] = $operation;
6666

6767
// Pause the ad on the server.
68-
$result = $adGroupAdService->mutate($operations);
68+
$adGroupAd = $adGroupAdService->mutate($operations)->getValue()[0];
6969
printf(
7070
"Ad of type '%s' with ID %d has updated status '%s'.\n",
71-
$adGroupAd->getAd()->getAdType(),
71+
$adGroupAd->getAd()->getType(),
7272
$adGroupAd->getAd()->getId(),
7373
$adGroupAd->getStatus()
7474
);

examples/AdWords/v201609/CampaignManagement/AddCompleteCampaignsUsingBatchJob.php

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,7 @@
4444
use Google\AdsApi\AdWords\v201609\cm\CampaignOperation;
4545
use Google\AdsApi\AdWords\v201609\cm\CampaignStatus;
4646
use Google\AdsApi\AdWords\v201609\cm\CpcBid;
47+
use Google\AdsApi\AdWords\v201609\cm\ExpandedTextAd;
4748
use Google\AdsApi\AdWords\v201609\cm\Keyword;
4849
use Google\AdsApi\AdWords\v201609\cm\KeywordMatchType;
4950
use Google\AdsApi\AdWords\v201609\cm\ManualCpcBiddingScheme;
@@ -211,10 +212,9 @@ private static function buildAdGroupAdOperations(array $adGroupOperations) {
211212
$adGroupAd->setAdGroupId($adGroupId);
212213

213214
$expandedTextAd = new ExpandedTextAd();
214-
$expandedTextAd->setHeadline('Luxury Cruise to Mars');
215-
$expandedTextAd->setDescription1('Visit the Red Planet in style.');
216-
$expandedTextAd->setDescription2('Low-gravity fun for everyone!');
217-
$expandedTextAd->setDisplayUrl('www.example.com');
215+
$expandedTextAd->setHeadlinePart1('Luxury Cruise to Mars');
216+
$expandedTextAd->setHeadlinePart2('Visit the Red Planet in style.');
217+
$expandedTextAd->setDescription('Low-gravity fun for everyone!');
218218
$expandedTextAd->setFinalUrls(['http://www.example.com/1']);
219219

220220
$adGroupAd->setAd($expandedTextAd);

examples/AdWords/v201609/CampaignManagement/AddKeywordsUsingIncrementalBatchJob.php

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ public static function runExample(AdWordsServices $adWordsServices,
7171
$batchJob->getId(), $batchJob->getStatus(), $uploadUrl);
7272

7373
// Use BatchJobs to upload all operations.
74-
$batchJobs = new BatchJobs();
74+
$batchJobs = new BatchJobs($session);
7575

7676
// Generate and upload the first set of operations.
7777
$adGroupCriterionOperations =

0 commit comments

Comments
 (0)