PowerNad
๊ณผ์ ์ฉ ํ๋ก์ ํธ์์๋ ๊ด์ฌ๊ฐ์ ธ ์ฃผ์ ์ ๊ฐ์ฌํฉ๋๋ค. :)
๋ณธ ๋ฌธ์ ๋๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ด์์ ์ธ๊ธ๋๋ 'Naver' ํน์ '๋ค์ด๋ฒ'๋ Naver Corp์ ์ํ์
๋๋ค.
'Naver' and '๋ค์ด๋ฒ' are trademarks of Naver Corp
What is PowerNad?
PowerNad๋ Power for NaverAD์ ์ฝ์๋ก ๋ค์ด๋ฒ ๊ด๊ณ API๋ฅผ Python์์ ์ฝ๊ฒ ์ฌ์ฉํ ์ ์๋๋ก ํด์ฃผ๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ ๋๋ค.
2017. 03. 15
๊ธฐ์ค์ผ๋ก ์ ์ฒด API์ค 90% ์ด์์ ์ปค๋ฒ์จ์ ๊ฐ์ง๊ณ ์์ต๋๋ค.ย
How to Install?
pip3 install powernad
or
git clone https://github.com/devkingsejong/python-PowerNad.git
How to Use?
powernad๋ ํฌ๊ฒ API๋ค์ด ์ ์ ๋์ด ์๋ API
์ Request Object๋ค์ด ์ ์๋์ด ์๋ Object
๋ก ๋๋์ด์ ธ ์์ต๋๋ค.
1. Include API
ํน์ API๋ฅผ ์ฌ์ฉํ๊ณ ์ถ๋ค๋ฉด,
from powernad.API.AdGroup import *
from powernad.API.Campaign import *
์์ ๊ฐ์ด ๋ค์ด๋ฒ ๊ด๊ณ API์ ์ ์๋์ด ์๋ API๋ช ์ importํฉ๋๋ค.
2. Initialize API
ad_group = AdGroup('API ํธ์ถ ์ฃผ์', 'API ํค', 'Secret ํค', '์ ์ ๊ณ ์ ๋ฒํธ')
campaign = Campaign('API ํธ์ถ ์ฃผ์', 'API ํค', 'Secret ํค', '์ ์ ๊ณ ์ ๋ฒํธ')
API ํธ์ถ ์ฃผ์
: API base url
API ํค
: api_key
Secret ํค
: secret_key
์ ์ ๊ณ ์ ๋ฒํธ
: customer_id
์์ ๊ฐ์ด Naver API ๊ด๋ฆฌํจ๋์์ ๋ฐ๊ธ๋ฐ์ ์ ๋ณด๋ฅผ ๋ฃ์ด, ์ด๊ธฐํ ํด์ค๋๋ค.
3. Use GET API
(1) ์บ ํ์ธ ์์ด๋๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ๊ทธ๋ฃน ๋ถ๋ฌ์ค๊ธฐ
group_list = campaign.get_adgroup_list('cmp-xxxxx')
(2) ๊ทธ๋ฃน ์์ด๋๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ๊ทธ๋ฃน ๋ฆฌ์คํธ ๋ถ๋ฌ์ค๊ธฐ
group_list2 = ad_group.get_adgroup_list_by_ids(๊ทธ๋ฃน๊ณ ์ ๋ฒํธ)
4. Use Post API(Require Request Params)
PowerNad์์๋ ๋ณด๋ค ์ฝ๊ฒ Request ํ๋ผ๋ฏธํฐ๋ฅผ ๊ตฌ์ฑํ ์ ์๋๋ก, ๋ฏธ๋ฆฌ ์ ์๋ Object
๋ชจ์์ ์ ๊ณตํฉ๋๋ค.
๋ง์ฝ ๊ทธ๋ฃน ์์ฑ API
๋ฅผ ์ฌ์ฉํ๊ณ ์ถ๋ค๋ฉด,
from powernad.API import AdGroup
from powernad.Object.AdGroup.RequestObject.CreateAdgroupObject import CreateAdgroupObject
ad_group = AdGroup('API ํธ์ถ ์ฃผ์', 'API ํค', 'Secret ํค', '์ ์ ๊ณ ์ ๋ฒํธ')
cad = CreateAdgroupObject('cmp-a000-00-0003', 'group Name', 'bsn-0001-00-0001', 'bsn-a001-00-0002')
ad_group.create_adgroup(cad)
์์ ๊ฐ์ด Object๋ฅผ APIํ๋ผ๋ฏธํฐ์ ๋ฃ์ด์ฃผ๋ ๊ฒ ๋ง์ผ๋ก ๊ฐ๋จํ๊ฒ ์ฌ์ฉํ ์ ์์ต๋๋ค. (ํ์ parameter๋ ์์ฑ์๋ก ์ ์ ๊ฐ๋ฅํฉ๋๋ค.)
License
Copyright (c) <2017> <devkingsejong>
์ด ์ํํธ์จ์ด์ ๋ณต์ ๋ณธ๊ณผ ๊ด๋ จ๋ ๋ฌธ์ํ ํ์ผ(โ์ํํธ์จ์ดโ)์ ํ๋ํ๋ ์ฌ๋์ ๋๊ตฌ๋ผ๋ ์ํํธ์จ์ด๋ฅผ ๋ณ๋ค๋ฅธ ์ ํ ์์ด ๋ฌด์์ผ๋ก ์ฌ์ฉํ ์ ์๋ ๊ถํ์ ๋ถ์ฌ ๋ฐ๋๋ค. ์ฌ๊ธฐ์๋ ์ํํธ์จ์ด์ ๋ณต์ ๋ณธ์ ๋ฌด์ ํ์ผ๋ก ์ฌ์ฉ, ๋ณต์ , ์์ , ๋ณํฉ, ๊ณตํ, ๋ฐฐํฌ, ์๋ธ๋ผ์ด์ ์ค ์ค์ ๋ฐ ํ๋งคํ ์ ์๋ ๊ถ๋ฆฌ์ ์ด์์ ํ์๋ฅผ ์ํํธ์จ์ด๋ฅผ ์ ๊ณต๋ฐ์ ๋ค๋ฅธ ์์ทจ์ธ๋ค์๊ฒ ํ์ฉํ ์ ์๋ ๊ถ๋ฆฌ๊ฐ ํฌํจ๋๋ฉฐ, ๋ค์๊ณผ ๊ฐ์ ์กฐ๊ฑด์ ์ถฉ์กฑ์ํค๋ ๊ฒ์ ์ ์ ๋ก ํ๋ค.
์์ ๊ฐ์ ์ ์๊ถ ์๋ด ๋ฌธ๊ตฌ์ ๋ณธ ํ์ฉ ๋ฌธ๊ตฌ๊ฐ ์ํํธ์จ์ด์ ๋ชจ๋ ๋ณต์ ๋ณธ ๋ฐ ์ค์ ๋ถ๋ถ์ ํฌํจ๋์ด์ผ ํ๋ค.
์ด ์ํํธ์จ์ด๋ ์ํ์ฑ, ํน์ ๋ชฉ์ ์ ํฉ์ฑ, ๊ทธ๋ฆฌ๊ณ ๋น์นจํด์ ๋ํ ๋ณด์ฆ์ ํฌํจํ ์ด๋ ํ ํํ์ ๋ณด์ฆ๋ ๋ช ์์ ์ด๋ ๋ฌต์์ ์ผ๋ก ์ค์ ๋์ง ์์ โ์๋ ๊ทธ๋๋ก์โ ์ํ๋ก ์ ๊ณต๋๋ค. ์ํํธ์จ์ด๋ฅผ ๊ฐ๋ฐํ ํ๋ก๊ทธ๋๋จธ๋ ์ ์๊ถ์๋ ์ด๋ ํ ๊ฒฝ์ฐ์๋ ์ํํธ์จ์ด๋ ์ํํธ์จ์ด์ ์ฌ์ฉ ๋ฑ์ ํ์์ ๊ด๋ จํ์ฌ ์ผ์ด๋๋ ์ด๋ค ์๊ตฌ์ฌํญ์ด๋ ์ํด ๋ฐ ๊ธฐํ ์ฑ ์์ ๋ํด ๊ณ์ฝ์, ๋ถ๋ฒํ์ ๋๋ ๊ธฐํ ์ด์ ๋ก ์ธํ ์ฑ ์์ ์ง์ง ์๋๋ค.