1. ওভারভিউ
এই কোডল্যাবে, আপনি শিখবেন কিভাবে আপনি সর্বাধিক সাধারণ সফ্টওয়্যার লাইসেন্সগুলির বিশ্লেষণের জন্য একটি কাস্টম উপস্থাপনা সরঞ্জাম হিসাবে Google স্লাইডগুলি ব্যবহার করতে পারেন৷ আপনি BigQuery API ব্যবহার করে GitHub-এ সমস্ত ওপেন সোর্স কোড জিজ্ঞাসা করবেন এবং আপনার ফলাফলগুলি উপস্থাপন করতে Google স্লাইড API ব্যবহার করে একটি স্লাইড ডেক তৈরি করবেন। নমুনা অ্যাপ্লিকেশনটি Node.js ব্যবহার করে তৈরি করা হয়েছে, তবে একই মৌলিক নীতিগুলি যে কোনও আর্কিটেকচারে প্রযোজ্য।
আপনি কি শিখবেন
- স্লাইড API ব্যবহার করে উপস্থাপনা তৈরি করা
- একটি বড় ডেটাসেটের অন্তর্দৃষ্টি পেতে BigQuery ব্যবহার করা
- গুগল ড্রাইভ API ব্যবহার করে একটি ফাইল অনুলিপি করা
আপনি কি প্রয়োজন হবে
- Node.js ইনস্টল করা হয়েছে
- ইন্টারনেট এবং একটি ওয়েব ব্রাউজারে অ্যাক্সেস
- একটি Google অ্যাকাউন্ট
- একটি Google ক্লাউড প্ল্যাটফর্ম প্রকল্প
2. নমুনা কোড পান
আপনি হয় আপনার কম্পিউটারে সমস্ত নমুনা কোড ডাউনলোড করতে পারেন...
...অথবা কমান্ড লাইন থেকে GitHub সংগ্রহস্থল ক্লোন করুন।
git clone https://github.com/googleworkspace/slides-api.git
রিপোজিটরিতে একটি ডিরেক্টরির একটি সেট রয়েছে যা প্রক্রিয়া বরাবর প্রতিটি ধাপের প্রতিনিধিত্ব করে, যদি আপনাকে একটি কার্যকরী সংস্করণ উল্লেখ করতে হয়।
আপনি start
ডিরেক্টরিতে অবস্থিত অনুলিপিটি বন্ধ করে কাজ করবেন, তবে আপনি প্রয়োজন অনুসারে অন্যদের থেকে ফাইলগুলি উল্লেখ বা অনুলিপি করতে পারেন।
3. নমুনা অ্যাপ চালান
প্রথমে, এর নোড স্ক্রিপ্ট আপ এবং চলমান পেতে. কোডটি ডাউনলোড করার সাথে সাথে, Node.js অ্যাপ্লিকেশনটি ইনস্টল এবং শুরু করতে নীচের নির্দেশাবলী অনুসরণ করুন:
- আপনার কম্পিউটারে একটি কমান্ড লাইন টার্মিনাল খুলুন এবং কোডল্যাবের
start
ডিরেক্টরিতে নেভিগেট করুন। - Node.js নির্ভরতা ইনস্টল করতে নিম্নলিখিত কমান্ডটি লিখুন।
npm install
- স্ক্রিপ্ট চালানোর জন্য নিম্নলিখিত কমান্ড লিখুন:
node .
- এই প্রকল্পের পদক্ষেপগুলি দেখায় এমন অভিবাদনটি পর্যবেক্ষণ করুন।
-- Start generating slides. --
TODO: Get Client Secrets
TODO: Authorize
TODO: Get Data from BigQuery
TODO: Create Slides
TODO: Open Slides
-- Finished generating slides. --
আপনি slides.js
, license.js
, এবং auth.js
এ আমাদের TODO-র তালিকা দেখতে পারেন। মনে রাখবেন যে অ্যাপটি সম্পূর্ণ করার জন্য প্রয়োজনীয় পদক্ষেপগুলিকে চেইন করতে আমরা JavaScript প্রতিশ্রুতি ব্যবহার করি কারণ প্রতিটি পদক্ষেপ পূর্ববর্তী পদক্ষেপের উপর নির্ভর করে।
আপনি যদি প্রতিশ্রুতির সাথে পরিচিত না হন তবে চিন্তা করবেন না, আমরা আপনার প্রয়োজনীয় সমস্ত কোড সরবরাহ করব৷ সংক্ষেপে, প্রতিশ্রুতিগুলি আমাদের আরও সিঙ্ক্রোনাস ফ্যাশনে অ্যাসিঙ্ক্রোনাস প্রক্রিয়াকরণ পরিচালনা করার একটি উপায় দেয়।
4. গ্রাহকের গোপনীয়তা পান
স্লাইড, বিগকুয়েরি এবং ড্রাইভ API ব্যবহার করতে, আমরা একটি OAuth ক্লায়েন্ট এবং একটি পরিষেবা অ্যাকাউন্ট তৈরি করব৷
Google Developers Console সেটআপ করুন
- Google বিকাশকারী কনসোলে একটি প্রকল্প তৈরি বা নির্বাচন করতে এবং স্বয়ংক্রিয়ভাবে API চালু করতে এই উইজার্ডটি ব্যবহার করুন৷ Continue-এ ক্লিক করুন, তারপর শংসাপত্রে যান ।
- আপনার প্রকল্প পৃষ্ঠায় শংসাপত্র যোগ করুন , বাতিল বোতামে ক্লিক করুন।
- পৃষ্ঠার শীর্ষে, OAuth সম্মতি স্ক্রিন ট্যাবটি নির্বাচন করুন। একটি ইমেল ঠিকানা নির্বাচন করুন, পণ্যের নাম লিখুন
Slides API Codelab
, এবং সংরক্ষণ বোতামে ক্লিক করুন।
BigQuery, ড্রাইভ এবং স্লাইড এপিআই সক্ষম করুন
- ড্যাশবোর্ড ট্যাবটি নির্বাচন করুন, API সক্ষম করুন বোতামে ক্লিক করুন এবং নিম্নলিখিত 3টি API সক্ষম করুন:
- BigQuery API
- গুগল ড্রাইভ এপিআই
- Google স্লাইড API
OAuth ক্লায়েন্ট সিক্রেট ডাউনলোড করুন (স্লাইড এবং ড্রাইভের জন্য)
- শংসাপত্র ট্যাব নির্বাচন করুন, শংসাপত্র তৈরি করুন বোতামে ক্লিক করুন এবং OAuth ক্লায়েন্ট আইডি নির্বাচন করুন।
- অন্যান্য অ্যাপ্লিকেশনের ধরনটি নির্বাচন করুন,
Google Slides API Codelab
নামটি লিখুন এবং তৈরি করুন বোতামে ক্লিক করুন৷ ফলে ডায়ালগটি খারিজ করতে ওকে ক্লিক করুন৷ - ক্লায়েন্ট আইডির ডানদিকে ফাইল_ডাউনলোড (JSON ডাউনলোড করুন) বোতামে ক্লিক করুন।
- আপনার গোপন ফাইলটিকে
client_secret.json
এ পুনঃনামকরণ করুন এবং এটি উভয় start/ এবং finish/ ডিরেক্টরিতে অনুলিপি করুন।
সার্ভিস অ্যাকাউন্ট সিক্রেট ডাউনলোড করুন (BigQuery-এর জন্য)
- শংসাপত্র ট্যাবটি নির্বাচন করুন, শংসাপত্র তৈরি করুন বোতামে ক্লিক করুন এবং পরিষেবা অ্যাকাউন্ট কী নির্বাচন করুন।
- ড্রপডাউনে, নতুন পরিষেবা অ্যাকাউন্ট নির্বাচন করুন। আপনার পরিষেবার জন্য নাম
Slides API Codelab Service
চয়ন করুন৷ তারপর ভূমিকা ক্লিক করুন এবং BigQuery- এ স্ক্রোল করুন এবং BigQuery ডেটা ভিউয়ার এবং BigQuery কাজের ব্যবহারকারী উভয়ই নির্বাচন করুন। - কী ধরনের জন্য, JSON নির্বাচন করুন।
- তৈরি করুন ক্লিক করুন। কী ফাইলটি স্বয়ংক্রিয়ভাবে আপনার কম্পিউটারে ডাউনলোড হয়ে যাবে। প্রদর্শিত ডায়ালগ থেকে প্রস্থান করতে বন্ধ ক্লিক করুন।
- আপনার গোপন ফাইলের নাম
service_account_secret.json
এ পুনঃনামকরণ করুন এবং এটি উভয় start/ এবং finish/ ডিরেক্টরিতে অনুলিপি করুন।
ক্লায়েন্ট সিক্রেটস পান
start/auth.js
এ, getClientSecrets
পদ্ধতিটি পূরণ করা যাক।
auth.js
const fs = require('fs');
/**
* Loads client secrets from a local file.
* @return {Promise} A promise to return the secrets.
*/
module.exports.getClientSecrets = () => {
return new Promise((resolve, reject) => {
fs.readFile('client_secret.json', (err, content) => {
if (err) return reject('Error loading client secret file: ' + err);
console.log('loaded secrets...');
resolve(JSON.parse(content));
});
});
}
আমরা এখন ক্লায়েন্টের গোপনীয়তা লোড করেছি। শংসাপত্রগুলি পরবর্তী প্রতিশ্রুতিতে পাস করা হবে। node .
কোন ত্রুটি আছে তা নিশ্চিত করতে।
5. একটি OAuth2 ক্লায়েন্ট তৈরি করুন
স্লাইড তৈরি করতে, আসুন আমাদের auth.js ফাইলে নিম্নলিখিত কোড যোগ করে Google API-এ প্রমাণীকরণ যোগ করি। এই প্রমাণীকরণটি Google ড্রাইভে ফাইলগুলি পড়তে এবং লিখতে, Google স্লাইডে উপস্থাপনা তৈরি করতে এবং Google BigQuery থেকে শুধুমাত্র পঠনযোগ্য প্রশ্নগুলি চালানোর জন্য আপনার Google অ্যাকাউন্টে অ্যাক্সেসের অনুরোধ করবে৷ (দ্রষ্টব্য: আমরা getClientSecrets
পরিবর্তন করিনি)
auth.js
const fs = require('fs');
const readline = require('readline');
const openurl = require('openurl');
const googleAuth = require('google-auth-library');
const TOKEN_DIR = (process.env.HOME || process.env.HOMEPATH ||
process.env.USERPROFILE) + '/.credentials/';
const TOKEN_PATH = TOKEN_DIR + 'slides.googleapis.com-nodejs-quickstart.json';
// If modifying these scopes, delete your previously saved credentials
// at ~/.credentials/slides.googleapis.com-nodejs-quickstart.json
const SCOPES = [
'https://www.googleapis.com/auth/presentations', // needed to create slides
'https://www.googleapis.com/auth/drive', // read and write files
'https://www.googleapis.com/auth/bigquery.readonly' // needed for bigquery
];
/**
* Loads client secrets from a local file.
* @return {Promise} A promise to return the secrets.
*/
module.exports.getClientSecrets = () => {
return new Promise((resolve, reject) => {
fs.readFile('client_secret.json', (err, content) => {
if (err) return reject('Error loading client secret file: ' + err);
console.log('loaded secrets...');
resolve(JSON.parse(content));
});
});
}
/**
* Create an OAuth2 client promise with the given credentials.
* @param {Object} credentials The authorization client credentials.
* @param {function} callback The callback for the authorized client.
* @return {Promise} A promise to return the OAuth client.
*/
module.exports.authorize = (credentials) => {
return new Promise((resolve, reject) => {
console.log('authorizing...');
const clientSecret = credentials.installed.client_secret;
const clientId = credentials.installed.client_id;
const redirectUrl = credentials.installed.redirect_uris[0];
const auth = new googleAuth();
const oauth2Client = new auth.OAuth2(clientId, clientSecret, redirectUrl);
// Check if we have previously stored a token.
fs.readFile(TOKEN_PATH, (err, token) => {
if (err) {
getNewToken(oauth2Client).then(() => {
resolve(oauth2Client);
});
} else {
oauth2Client.credentials = JSON.parse(token);
resolve(oauth2Client);
}
});
});
}
/**
* Get and store new token after prompting for user authorization, and then
* fulfills the promise. Modifies the `oauth2Client` object.
* @param {google.auth.OAuth2} oauth2Client The OAuth2 client to get token for.
* @return {Promise} A promise to modify the oauth2Client credentials.
*/
function getNewToken(oauth2Client) {
console.log('getting new auth token...');
openurl.open(oauth2Client.generateAuthUrl({
access_type: 'offline',
scope: SCOPES
}));
console.log(''); // \n
return new Promise((resolve, reject) => {
const rl = readline.createInterface({
input: process.stdin,
output: process.stdout
});
rl.question('Enter the code from that page here: ', (code) => {
rl.close();
oauth2Client.getToken(code, (err, token) => {
if (err) return reject(err);
oauth2Client.credentials = token;
let storeTokenErr = storeToken(token);
if (storeTokenErr) return reject(storeTokenErr);
resolve();
});
});
});
}
/**
* Store token to disk be used in later program executions.
* @param {Object} token The token to store to disk.
* @return {Error?} Returns an error or undefined if there is no error.
*/
function storeToken(token) {
try {
fs.mkdirSync(TOKEN_DIR);
fs.writeFileSync(TOKEN_PATH, JSON.stringify(token));
} catch (err) {
if (err.code != 'EEXIST') return err;
}
console.log('Token stored to ' + TOKEN_PATH);
}
6. BigQuery সেটআপ করুন৷
BigQuery এক্সপ্লোর করুন (ঐচ্ছিক)
BigQuery আমাদের সেকেন্ডের মধ্যে বিশাল ডেটাসেট অনুসন্ধান করতে দেয়। প্রোগ্রাম্যাটিকভাবে প্রশ্ন করার আগে ওয়েব ইন্টারফেস ব্যবহার করা যাক। আপনি যদি আগে কখনও BigQuery সেট-আপ না করে থাকেন, তাহলে এই কুইকস্টার্টের ধাপগুলি অনুসরণ করুন ।
BigQuery-এ উপলব্ধ GitHub ডেটা ব্রাউজ করতে ক্লাউড কনসোল খুলুন এবং আপনার নিজস্ব প্রশ্নগুলি চালান। আসুন এই ক্যোয়ারীটি লিখে এবং রান বোতাম টিপে গিটহাবের সর্বাধিক জনপ্রিয় সফ্টওয়্যার লাইসেন্সগুলি খুঁজে বের করি।
bigquery.sql
WITH AllLicenses AS (
SELECT * FROM `bigquery-public-data.github_repos.licenses`
)
SELECT
license,
COUNT(*) AS count,
ROUND((COUNT(*) / (SELECT COUNT(*) FROM AllLicenses)) * 100, 2) AS percent
FROM `bigquery-public-data.github_repos.licenses`
GROUP BY license
ORDER BY count DESC
LIMIT 10
আমরা শুধু GitHub-এ লক্ষ লক্ষ পাবলিক রেপো বিশ্লেষণ করেছি এবং সবচেয়ে জনপ্রিয় লাইসেন্স খুঁজে পেয়েছি। শান্ত! এখন একই ক্যোয়ারী চলমান সেটআপ করা যাক, কিন্তু এই সময় প্রোগ্রামগতভাবে.
BigQuery সেটআপ করুন
license.js
ফাইলে কোডটি প্রতিস্থাপন করুন। ফাংশন bigquery.query
একটি প্রতিশ্রুতি প্রদান করবে।
লাইসেন্স **.js**
const google = require('googleapis');
const read = require('read-file');
const BigQuery = require('@google-cloud/bigquery');
const bigquery = BigQuery({
credentials: require('./service_account_secret.json')
});
// See codelab for other queries.
const query = `
WITH AllLicenses AS (
SELECT * FROM \`bigquery-public-data.github_repos.licenses\`
)
SELECT
license,
COUNT(*) AS count,
ROUND((COUNT(*) / (SELECT COUNT(*) FROM AllLicenses)) * 100, 2) AS percent
FROM \`bigquery-public-data.github_repos.licenses\`
GROUP BY license
ORDER BY count DESC
LIMIT 10
`;
/**
* Get the license data from BigQuery and our license data.
* @return {Promise} A promise to return an object of licenses keyed by name.
*/
module.exports.getLicenseData = (auth) => {
console.log('querying BigQuery...');
return bigquery.query({
query,
useLegacySql: false,
useQueryCache: true,
}).then(bqData => Promise.all(bqData[0].map(getLicenseText)))
.then(licenseData => new Promise((resolve, reject) => {
resolve([auth, licenseData]);
}))
.catch((err) => console.error('BigQuery error:', err));
}
/**
* Gets a promise to get the license text about a license
* @param {object} licenseDatum An object with the license's
* `license`, `count`, and `percent`
* @return {Promise} A promise to return license data with license text.
*/
function getLicenseText(licenseDatum) {
const licenseName = licenseDatum.license;
return new Promise((resolve, reject) => {
read(`licenses/${licenseName}.txt`, 'utf8', (err, buffer) => {
if (err) return reject(err);
resolve({
licenseName,
count: licenseDatum.count,
percent: licenseDatum.percent,
license: buffer.substring(0, 1200) // first 1200 characters
});
});
});
}
আমাদের প্রতিশ্রুতির কলব্যাকের ভিতরে কিছু ডেটা console.log
করার চেষ্টা করুন আমাদের অবজেক্টের গঠন বোঝার জন্য এবং কোডটি কাজ করছে দেখতে।
7. স্লাইড তৈরি করুন
এখন মজা অংশ জন্য! স্লাইড এপিআই-এর create
এবং batchUpdate
পদ্ধতিতে কল করে স্লাইড তৈরি করি। আমাদের ফাইলটি নিম্নলিখিতগুলির সাথে প্রতিস্থাপন করা উচিত:
slides.js
const google = require('googleapis');
const slides = google.slides('v1');
const drive = google.drive('v3');
const openurl = require('openurl');
const commaNumber = require('comma-number');
const SLIDE_TITLE_TEXT = 'Open Source Licenses Analysis';
/**
* Get a single slide json request
* @param {object} licenseData data about the license
* @param {object} index the slide index
* @return {object} The json for the Slides API
* @example licenseData: {
* "licenseName": "mit",
* "percent": "12.5",
* "count": "1667029"
* license:"<body>"
* }
* @example index: 3
*/
function createSlideJSON(licenseData, index) {
// Then update the slides.
const ID_TITLE_SLIDE = 'id_title_slide';
const ID_TITLE_SLIDE_TITLE = 'id_title_slide_title';
const ID_TITLE_SLIDE_BODY = 'id_title_slide_body';
return [{
// Creates a "TITLE_AND_BODY" slide with objectId references
createSlide: {
objectId: `${ID_TITLE_SLIDE}_${index}`,
slideLayoutReference: {
predefinedLayout: 'TITLE_AND_BODY'
},
placeholderIdMappings: [{
layoutPlaceholder: {
type: 'TITLE'
},
objectId: `${ID_TITLE_SLIDE_TITLE}_${index}`
}, {
layoutPlaceholder: {
type: 'BODY'
},
objectId: `${ID_TITLE_SLIDE_BODY}_${index}`
}]
}
}, {
// Inserts the license name, percent, and count in the title
insertText: {
objectId: `${ID_TITLE_SLIDE_TITLE}_${index}`,
text: `#${index + 1} ${licenseData.licenseName} — ~${licenseData.percent}% (${commaNumber(licenseData.count)} repos)`
}
}, {
// Inserts the license in the text body paragraph
insertText: {
objectId: `${ID_TITLE_SLIDE_BODY}_${index}`,
text: licenseData.license
}
}, {
// Formats the slide paragraph's font
updateParagraphStyle: {
objectId: `${ID_TITLE_SLIDE_BODY}_${index}`,
fields: '*',
style: {
lineSpacing: 10,
spaceAbove: {magnitude: 0, unit: 'PT'},
spaceBelow: {magnitude: 0, unit: 'PT'},
}
}
}, {
// Formats the slide text style
updateTextStyle: {
objectId: `${ID_TITLE_SLIDE_BODY}_${index}`,
style: {
bold: true,
italic: true,
fontSize: {
magnitude: 10,
unit: 'PT'
}
},
fields: '*',
}
}];
}
/**
* Creates slides for our presentation.
* @param {authAndGHData} An array with our Auth object and the GitHub data.
* @return {Promise} A promise to return a new presentation.
* @see https://developers.google.com/apis-explorer/#p/slides/v1/
*/
module.exports.createSlides = (authAndGHData) => new Promise((resolve, reject) => {
console.log('creating slides...');
const [auth, ghData] = authAndGHData;
// First copy the template slide from drive.
drive.files.copy({
auth: auth,
fileId: '1toV2zL0PrXJOfFJU-NYDKbPx9W0C4I-I8iT85TS0fik',
fields: 'id,name,webViewLink',
resource: {
name: SLIDE_TITLE_TEXT
}
}, (err, presentation) => {
if (err) return reject(err);
const allSlides = ghData.map((data, index) => createSlideJSON(data, index));
slideRequests = [].concat.apply([], allSlides); // flatten the slide requests
slideRequests.push({
replaceAllText: {
replaceText: SLIDE_TITLE_TEXT,
containsText: { text: '{{TITLE}}' }
}
})
// Execute the requests
slides.presentations.batchUpdate({
auth: auth,
presentationId: presentation.id,
resource: {
requests: slideRequests
}
}, (err, res) => {
if (err) {
reject(err);
} else {
resolve(presentation);
}
});
});
});
8. স্লাইড খুলুন
সবশেষে, ব্রাউজারে উপস্থাপনাটি খুলি। slides.js
এ নিম্নলিখিত পদ্ধতিটি আপডেট করুন।
slides.js
/**
* Opens a presentation in a browser.
* @param {String} presentation The presentation object.
*/
module.exports.openSlidesInBrowser = (presentation) => {
console.log('Presentation URL:', presentation.webViewLink);
openurl.open(presentation.webViewLink);
}
চূড়ান্ত ফলাফল দেখানোর জন্য আপনার প্রকল্পটি শেষবার চালান।
9. অভিনন্দন!
আপনি BigQuery ব্যবহার করে বিশ্লেষণ করা ডেটা থেকে সফলভাবে Google স্লাইড তৈরি করেছেন। আপনার স্ক্রিপ্ট সবচেয়ে সাধারণ সফ্টওয়্যার লাইসেন্সগুলির একটি বিশ্লেষণ রিপোর্ট করতে Google স্লাইড API এবং BigQuery ব্যবহার করে একটি উপস্থাপনা তৈরি করে৷
সম্ভাব্য উন্নতি
আরও জোরদার একীকরণ করার জন্য এখানে কিছু অতিরিক্ত ধারণা রয়েছে:
- প্রতিটি স্লাইডে ছবি যোগ করুন
- Gmail API ব্যবহার করে ইমেলের মাধ্যমে আপনার স্লাইড শেয়ার করুন
- কমান্ড লাইন আর্গুমেন্ট হিসাবে টেমপ্লেট স্লাইড কাস্টমাইজ করুন
আরও জানুন
- Google Slides API ডেভেলপার ডকুমেন্টেশন পড়ুন।
- প্রশ্ন পোস্ট করুন এবং google-slides-api ট্যাগের অধীনে স্ট্যাক ওভারফ্লোতে উত্তর খুঁজুন।