আপনি সবকিছু সেট আপ করার পরে, আপনি সফলভাবে অনুসন্ধান বিজ্ঞাপন 360 API-এ একটি নমুনা অনুরোধ পাঠাতে পারেন তা নিশ্চিত করুন। নিচের কোড নমুনাটি দেখায় কিভাবে আপনার বিজ্ঞাপনদাতার অধীনে প্রচারাভিযানের তালিকার জন্য একটি অ্যাসিঙ্ক্রোনাস অনুরোধ পাঠাতে হয়। অনুরোধটি সফল হলে, আপনি Search Ads 360 API থেকে একটি প্রতিক্রিয়া পাবেন যাতে বলা হয় যে রিপোর্ট তৈরি করা হয়েছে কিন্তু প্রস্তুত নয় (এটি কারণ অ্যাসিঙ্ক্রোনাস অনুরোধের জন্য একটি প্রতিবেদন ডাউনলোড করার জন্য অতিরিক্ত অনুরোধের প্রয়োজন হয়)।
অনুরোধে আপনাকে আপনার নিজস্ব OAuth 2.0 অ্যাক্সেস টোকেন এবং আপনার নিজস্ব এজেন্সি আইডি উল্লেখ করতে হবে। আপনার এজেন্সি আইডি খুঁজে পেতে:
- অনুসন্ধান বিজ্ঞাপন 360 UI দেখুন।
- আপনার এজেন্সি এবং বিজ্ঞাপনদাতা আইডি URL-এ
ay=এবংav=উপসর্গের পরে প্রদর্শিত হয়। যেমন:
https://searchads.google.com/ds/cm/cm/cm/cm#campaigns.ay= 123456789012345678 ;av= 123456789012345678 ;
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/reports
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"reportScope": {
"agencyId": "your agency ID",
"advertiserId": "your advertiser ID"
},
"reportType": "campaign",
"columns": [
{ "columnName": "campaignId" },
{ "columnName": "campaign" }
],
"downloadFormat": "csv",
"maxRowsPerFile": 6000000,
"statisticsCurrency": "agency"
}
এই অনুরোধ পাঠাতে Search Ads 360 ইউটিলিটি স্ক্রিপ্ট ব্যবহার করুন
একটি কাঁচা JSON POST অনুরোধ পাঠাতে, আপনি sa360Api.py স্ক্রিপ্টটি নিম্নরূপ ব্যবহার করতে পারেন:
-
request.txt.txt নামে একটি নতুন টেক্সট ফাইলে উদাহরণ JSON অবজেক্ট (দুটি কোঁকড়া বন্ধনী সহ এবং এর মধ্যে সবকিছু) অনুলিপি করুন। - JSON কোডে থাকা এজেন্সি আইডিটি আপনার নিজস্ব এজেন্সি আইডিতে পরিবর্তন করুন।
- কোনো মন্তব্য মুছে ফেলুন, যেমন
// The date column segments the report by individual days. - আপনার OAuth 2.0 শংসাপত্রগুলিকে একটি একক, কমা-ডিলিমিটেড স্ট্রিং-এ একত্রিত করুন:
client-ID,client-secret,refresh-token
(এটি একই স্ট্রিং যাsa360Api.pyআউটপুট করে যখন আপনিsa360Api.py --loginচালান যেমন সেট আপ অনুমোদনে বর্ণিত হয়েছে।) - নিম্নরূপ
sa360Api.pyআহ্বান করুন:
sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
উপরের কমান্ডে,CREDENTIALSজন্য আগের ধাপে আপনি যে স্ট্রিংটি একত্রিত করেছিলেন সেটি প্রতিস্থাপন করুন।
API-methodজন্য নীচের বাক্সে POST পদ্ধতির নাম প্রতিস্থাপন করুন।যেমন:
sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/reports/generate --post < request.txt
জাভা
import com.google.api.client.googleapis.json.GoogleJsonError.ErrorInfo;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.services.doubleclicksearch.Doubleclicksearch;
import com.google.api.services.doubleclicksearch.model.ReportApiColumnSpec;
import com.google.api.services.doubleclicksearch.model.ReportRequest;
import com.google.api.services.doubleclicksearch.model.ReportRequest.ReportScope;
import com.google.api.services.doubleclicksearch.model.ReportRequest.TimeRange;
import java.io.IOException;
import java.util.Arrays;
/**
* Creates a campaign report request, submits the report, and returns the report ID.
*/
private static String createReport(Doubleclicksearch service) throws IOException {
try {
return service.reports().request(createSampleRequest()).execute().getId();
} catch (GoogleJsonResponseException e) {
System.err.println("Report request was rejected.");
for (ErrorInfo error : e.getDetails().getErrors()) {
System.err.println(error.getMessage());
}
System.exit(e.getStatusCode());
return null; // Unreachable code.
}
}
/**
* Returns a simple static request that lists the ID and name of all
* campaigns under agency 20100000000000895 and advertiser 21700000000011523.
* Substitute your own agency ID and advertiser IDs for the IDs in this sample.
*/
private static ReportRequest createSampleRequest() {
return new ReportRequest()
.setReportScope(new ReportScope()
.setAgencyId(20100000000000895L) // Replace with your ID
.setAdvertiserId(21700000000011523L)) // Replace with your ID
.setReportType("campaign")
.setColumns(Arrays.asList(
new ReportApiColumnSpec[] {
new ReportApiColumnSpec().setColumnName("campaignId"),
new ReportApiColumnSpec().setColumnName("campaign")
}))
.setTimeRange(new TimeRange()
.setStartDate("2014-05-01")
.setEndDate("2014-05-01"))
.setDownloadFormat("csv")
.setStatisticsCurrency("usd")
.setMaxRowsPerFile(5000000);
}
.নেট
using System;
using System.Collections.Generic;
using System.IO;
using System.Threading;
using Google.Apis.Auth.OAuth2;
using Google.Apis.Auth.OAuth2.Flows;
using api = Google.Apis.Doubleclicksearch.v2;
/// <summary>
/// Creates a campaign report request, submits the report, and returns the report ID.
/// </summary>
/// <param name="service">Search Ads API service.</param>
private static string CreateReport(api.DoubleclicksearchService service)
{
var req = service.Reports.Request(CreateSampleRequest());
var report = req.Execute();
Console.WriteLine("Created report: ID={0}", report.Id);
return report.Id;
}
/// <summary>
/// Returns a simple static request that lists the ID and name of all
/// campaigns under agency 20100000000000895 and advertiser 21700000000011523.
/// Substitute your own agency ID and advertiser IDs for the IDs in this sample.
/// </summary>
private static api.Data.ReportRequest CreateSampleRequest()
{
return new api.Data.ReportRequest
{
ReportScope = new api.Data.ReportRequest.ReportScopeData
{
AgencyId = 20100000000000895,
AdvertiserId = 21700000000011523,
},
ReportType = "campaign",
Columns = new List
পাইথন
def generate_report(service):
"""Generate and print sample report.
Args:
service: An authorized Doubleclicksearch service. See Set Up Your Application.
"""
request = service.reports().request(
body =
{
"reportScope": {
"agencyId": "your agency ID",
"advertiserId": "your advertiser ID"
},
"reportType": "campaign",
"columns": [
{ "columnName": "campaignId" },
{ "columnName": "campaign" }
],
"downloadFormat": "csv",
"maxRowsPerFile": 6000000,
"statisticsCurrency": "agency"
}
)
pprint.pprint(request.execute())